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(57) Abstract: A framework enables data source 
components to be developed independently of data 
consumer components. ' A mediation layer,' typically 
implemented as a group of APIs (application 
programming interface), handles and dednes the 
mediation and interface between the source and 
data components. The framework, called XIS 
(extensible information system), is especially suited 
for development of in formation -handling systems 
and applications. Data source components and data 
consumer components are typically designed to 
communicate with each other via several interfaces. 
Domain, relationship, attribute/metadata, and change 
event interfaces are defined within the mediation 
layer. Other interfaces may also be defined Data 
source components that are written for non-XTS 
aware environments or frameworks may still be used 
with XIS by "wrapping" such source components 
with code to conform to the interface requirements. 
Java objects are examples of data source components. 
Data consumer components thus are able to use or 
consume various source components regardless of 
the data types and the data source. Thus, once a data 
consumer component is developed within the XTS 
framework, any data source components within the 
XIS framework may be consumed by a data consumer 
component. 
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EXTENSIBLE INFORMATION SYSTEM 

A portion of the disclosure of this patent document contains material, which is 
subject to copyright protection. The copyright owner has no objection to the facsimile 
reproduction by anyone of the patent document or the patent disclosure, as it appears 
in the Patent and Trademark Office patent file or records, but otherwise reserves all 
copyright rights whatsoever. > 

This application claims priority of co-pending U.S. Provisional Patent 
Application Serial No. 60/242,041 entitled "Extensible Information System (XIS)" by 
R. Kadel et al., filed October 20, 2000. Priority of the filing date of October 20, 2000 
is hereby claimed, and the disclosure of said Provisional Patent Application is hereby 
incorporated by reference. 

BACKGROUND 

1. Field Of The Invention 

The present invention relates generally to data processing systems and, more 
particularly, to systems that process, analyze, and display data or information. 

2. Description of the Related Art 

The continuing inroads made by computer technology into the practices of 
information storage and manipulation have opened up new realms of possibility for 
intelligent, informed decision-making. From labor statistics and scientific databases 
like the human genome project to traffic patterns and aircraft positions, the 
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availability of information in electronic form allows sophisticated analysis techniques 
and display methods to be applied at the touch of a button. However this diverse 
array of information also poses significant challenges in areas such as: 

effective organization of information; 
5 - ability to interpret and manipulate information in an increasingly 

wide variety of formats so that data and processing software can 

be brought together in a compatible but also timely and effective 

way; and 

recognizing and navigating relationships between disparate 

10 information types. 

This task of information management has already grown beyond the ability of 
human operators to keep pace with it, and in most applications, there is far more 
relevant information electronically available on the web and elsewhere than is 
effectively used. The problem is that software affording display of and interaction 

1 5 with information must be custom-designed for the particular type and format of the 
information it will work with. This leads to high costs of software development and 
limited availability of software appropriate to information of interest, and poor 
integration between information from different sources. An analyst must use one 
program when dealing with geographic distribution data such as precipitation amounts 

20 or land use, another for rendering 3 -dimensional terrain, another for examining 

congressional districts and voting records, and so on. Many desirable applications of 
available data, such as determining correlations between political party and land use 
strategy in this case, fall between the cracks left by specialized applications, and there 
is no easy way to allow them to interoperate. 

25 The primary means for allowing one application to operate on the results of 

another are the limited cut and paste facilities offered by many operating systems, 
which allow plain or formatted text or images to be moved between programs. There 
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is no independent way to transfer structured data such as a table of numbers with 
particular column headings, a set of lists of items under specified categories, or even • 
something as simple as a single number with an associated unit of measurement 
From the discussion above, it should be apparent that there is a need for 
5 computer systems that have greater ability to develop, integrate, and interoperate with 
disparate sources of information, to more easily develop software applications, 
components, or objects, and to facilitate interoperation of data between software 
components. .The present invention fulfills this need. 



10 SUMMARY OF THE INVENTION 

In accordance with the present invention, a framework for use with object 
oriented programming (OOP) systems provides a framework user with classes that 
comprise a mediation layer that defines an interface between data source components 

15 and data consumer components such that the configuration of the data source 

components can be specified independently of the data consumer components. The 
mediation layer specifies data relationships of the data objects, domain methods for 
defining groups of class attributes, attribute metadata for defining groups of class 
attributes, and change event registration for detecting changes in data values. Thus, 

20 when extended, the mediation layer of the framework can support runtime data 
manipulation between unrelated data source components and data consumer 
components. In this way, the framework provides an extensible information system. 
The framework will be referred to herein as "XIS", and is especially suited to assist in 
the development of information-handling systems or applications. 

25 Data source components that are configured for a non-XIS-aware 

programming environment or framework may still be used with XIS by "wrapping" 
such source components with code to conform to the interface requirements. Data 
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objects of the well-known "Java" programming language are examples of data source 
components. Data consumer components thus are able to use or consume various data 
source components regardless of the data types and the data source. Thus, once a data 
consumer component is developed within the XIS framework, any data source 
5 components within the XIS framework may also accordingly be used. The 

framework can be provided as a group of APIs (application programming interface). 

The XIS framework of the present invention also includes libraries and APIs 
that provide information management technologies that enable developers and 
integrators to combine XlS-aware components, data sources, and off-the-shelf 

10 JavaBeans into complete systems designed around whatever architecture is best for 
the situation. XIS further supports multiple, dynamic domains and is scalable to n-tier 
systems using the latest technology. The framework enables many developers to 
choose architectures based on their requirements (e.g., server, client/server, 
application server, web server, standalone, hand-held, etc.). 

15 Other features and advantages of the present invention should be apparent from 

the following description, which illustrates, by way of example, the principles of the 
invention. 

BRIEF DESCRIPTIONS OF THE FIGURES 

20 

Figure 1 is a diagram of the extensible information system (XIS) framework 
constructed in accordance with the present invention. 

Figure 2 is a more detailed diagram of Figure 1, showing the various interfaces 
within XIS, constructed in accordance with the present invention. 
25 Figure 3 A is a mqre detailed diagram of Figure 1, including information and 

services available within XIS, constructed in accordance with the present invention. 
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Figure 3B is a hierarchical structure diagram of an embodiment of an 
InfoModel constructed in accordance with the present invention. 

Figure 4 is a more detailed diagram of Figure 1 showing various information 
available to components within XIS constructed in accordance with the present 
5 invention. 

Figure 5 is a diagram of the semantic representation of a data item within the 
XIS framework constructed in accordance with the present invention. 

Figures 6 A to 6F show data consumer components, particularly display 
components, constructed in accordance with the present invention. 
10 Figure 7 shows a consumer component displaying the properties exposed by a 

data source object constructed in accordance with the present invention. 

Figure 8 is a unified modeling language (UML) diagram of a Person object 

Figure 9 lists a set of attributes exposed within the XIS framework by the 
Person object of Figure 6 constructed in accordance with the present invention. 
15 Figure 10 illustrates that an object constructed in accordance with the present 

invention may subscribe to more than one domain policy or definition. 

Figure 1 1 shows a domain usage and sequence scenario between a consumer 
component and source component constructed in accordance with the present 
invention. 

20 Figures 12 A to 12D list information regarding a Type Metadata package class 

typically implemented in the mediation layer and constructed in accordance with the 
present invention. 

Figure 13 shows a relationship usage scenario diagram between a consumer 
component and source component constructed in accordance with the present 
25 invention. 

Figure 14 is a flow chart that shows a reference resolution scenario usage 
sequence in which an indirect reference to an information element is created, passed 
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around, and then resolved by two separate data consumers, causing reconstruction to 
occur only the first time. 

Figure 15 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
5 Figures 16A to 16B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figure 17 shows a data consumer component using a source component 
constructed in accordance with the present invention. 
10 Figures 18A to 18B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 19 A to 19B list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
15 invention. 

Figure 20 shows a data consumer component using a source component 
constructed in accordance with the present invention. 

Figure 21 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
20 Figures 22A to 22C list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 23 A to 23D list ah exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
25 invention. 

Figures 24A and 24B show two data consumer components using a source 
component constructed in accordance with the present invention. 
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Figures 25 A to 25C list an exemplary Java source file to implement an 
infomation-handling application constructed in accordance with the present 
• invention. 

Figure 26 shows a data consumer component using a source component 
5 constructed in accordance with the present invention. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. 

Figure 28 is a diagram of how InfoModels constructed in accordance with the 
present invention provide contextualization with the XIS framework. 
io Figure 29 is a diagram of the pluggable service facilities within XIS 

constructed in accordance with the present invention. 

Figure 30 shows a flow diagram of a wizard or an API constructed in 
accordance with the present invention that assists in creating XML (extensible 
markup language) DSIs and database DSIs. 
15 Figure 31 shows objects and methods involved in distribution collaboration 

facilities constructed in accordance with the present invention. 

Figure 32 shows semantic repositories for distributed agents constructed in 
accordance with the present invention. 

Figures 33 A to 33P list information regarding a ContenQnfoBean class 
20 constructed in accordance with the present invention. 

Figures 34A to 34D list an information management package typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 35 A to 35F list an InfoMbdel interface package typically implemented 
25 in the mediation layer and constructed in accordance with the present invention. 
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Figures 36A to 36B list a package for handling change events typically 
implemented in the mediation layer and constructed in accordance with fee present 
invention. 

Figures 36C and 36D show two sequence diagrams showing how change 
5 • events are handled and constructed in accordance with the present invention. 

Figures 37A to 37D list an exemplary Java source file to implement an 
infonnation-handling application constructed in accordance with the present * 
invention. 

Figures 38A, 38B, 38C, and 38D show two data consumer components using a 
10 source component constructed in accordance with the present invention. 

Figures 39A, 39B, and 39C is list information concerning an AttributeAlias 
class of the framework. 

Figure 40 is a block diagram of a computer device that may be used to operate 
with the framework, in accordance with the present invention, 

15 

DETAILED DESCRIPTION 

The following detailed description illustrates the invention by way of example, 
not by way of limitation of the principles of the invention. This description will 

20 clearly enable one skilled in the art to make and use the invention, and describes 
several embodiments, adaptations, variations, alternatives and uses of the invention, 
including what we presently believe is the best mode of carrying out the invention-. 

The invention will be described by way of illustration with reference to various 
classes, objects, sample codes, etc. written within the exemplary framework, but it 

25 should be understood that such classes, class libraries, application programming 

interfaces, interfaces, objects, etc. maybe differently coded, implemented, designed, 
etc. and yet support the functions and features of the present invention. 
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Object-Oriented Technology 

Many application programs and APIs (application program interface) are 
developed using object-oriented (OO) technology. Using 00 technology, a system is 
typically developed as a collection of interrelated cooperative objects that are 
5 instances of classes that typically include corresponding states and behaviors^ A class 
is a blueprint or template that defines the variables and the methods common to all 
objects that are instances of the class. An object maintains its state in one or more 
variables and implements its behavior with methods or functions. 

Object-oriented programming (OOP) techniques encapsulate, or bind together, 

10 data and the methods that operate on them. This encapsulation permits program 
development to more closely model real-world entities and breaks up program 
development efforts into smaller, more manageable pieces. Although OOP 
techniques have done much to improve program development efficiency, such 
techniques still require a great degree of code generation on the part of developers, 

15 which discourages program reuse. 

Even with OOP techniques, specifying data sources and the way in which data 
will be retrieved or updated from the data sources are still typically hard-coded within 
the objects themselves. An object, for example, may be specified to display pricing 
data (for example, a price display object) and would likely be hard-coded such that 

20 the data source is predefined. Thus, an object may be written to retrieve data from a 
source such as a relational database management system (RDBMS), a spreadsheet file 
such as a spreadsheet in the format of "EXCEL" spreadsheet application by Microsoft 
Corporation, or the object may be written to an XML file. Nevertheless, in 
conventional systems, the price display object would be limited such that if a different 

25 source of data, for example, an XML file rather than an EXCEL file, has to be used, 
the object has to be modified to incorporate access to and manipulation of the XML 
file. Furthermore, if a different set of fields are retrieved, for example, latitude and 
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longitude (i.e., data fields unrelated to pricing information), a new object to display 
latitude and longitude may have to be written to display such information in tabular 
format. 

Table I below shows the data configuration of a typical object 



Table I 

State/Properties: Name, SSN, position, DOB, and . . ! 
Behavior: RecordQ 

getRecords(DateRange) 

promote Q 



For an application to be able to use this data object, the application would need 
prior knowledge of object properties (state) and behavior. The application would be 
tightly coupled with the class from which the object was instantiated. The meaning 
and intent of the data might be found in the source code or by asking the original 
programmers (e.g., SSN is social security number stored as string rather than a 
numeric type). 

Assuming the object was created by one application written independently of 
another, the object could not be intelligently exchanged between the first application 
and the other with the expectation that the object would be processed unless the 
applications were tightly coupled. A way to have objects be used in various 
applications is thus highly desirable to reduce programming time and resources. 

Common OOP languages include "Java" from Sun Microsystems, Inc. of Palo 
Alto, California, USA, C++, Simula, and Smalltalk. 
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Framework 

The concept of a framework is an important part of 00 programming 
technique. A framework is a specification of the classes and the relationships 
between classes such that the framework defines a class hierarchy that can be used 

5 over and over again, with overrides and extensions. In this way, an initial problem 
solution specified by a class hierarchy can be adapted and customized for new 
circumstances, simplifying program maintenance. In essence, a framework is a set of 
OOP classes that embodies a predetermined set of attributes and methods for 
providing a common group of behaviors. 

io OOP frameworks have been developed in an effort to further reduce program 

development costs. An application program developer utilizes the framework and 
builds upon it, starting with the classes, attributes, and methods defined by the 
framework designer and adding subclasses and attributes and modifying methods 
depending on the problem to be solved Such changes to the framework are typically 

is referred to as framework extensions, and are made possible by the OOP notions of 
inheritance and polymorphism. Thus, a framework can speed the development of an 
00 application program- The challenge confronting framework developers, then, is 
to define a set of classes and methods that best supports the desired problem solution 
and will accept the most likely framework extensions. Thus, the designer of a 

20 framework must carefully assess what framework users will most likely need in the 
way of classes, attributes, and methods. 

It is therefore a technical advantage of the present invention to provide a 
framework that allows information-handling software to adapt to new data types and 
formats of information, so that a single application built within this framework has a 

25 significantly broader range of compatibilities and domains of usefulness than a 

conventional application and, further, may automatically interoperate at a structured 
level with other similarly enhanced applications. In one embodiment of the present 
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invention, desirable applications of data such as detennining correlations between 
political party and land use strategy may be facilitated. 

La an embodiment of the present invention, a single information visualization 
or manipulation application is able to handle many diverse types of information, even 
5 those that are conceived and developed subsequently to the completion of 
development of the application itself. 

In another embodiment of the present invention, information from multiple and • 
diverse sources yet sharing some basic feature in common - such as being distributed 
in geographic space, or being distances measured in meters - can be simultaneously 
10 displayed (superimposed) and manipulated within a single application. This invention . 
further provides means of access to common data sources such as relational databases, 
extensible markup language (XML) streams, and "Java" programming language 
software objects. 

In an embodiment of the present invention, an information-handling 
15 application is defined as any software application which is capable of utilizing 

digitally available structured information in bulk form, such as from electronic files, 
databases, or internet web sites to provide a display and/or a set of possible 
manipulations to a user, such as after some internal processing and transformation of 
the information such as summarizing it, performing computations on it, or selecting a 
20 subset Examples include but are not limited to graphing programs, analysis tools (for 
handling financial data, statistical, time series, etc.), and interfaces to geographic 
information systems. Prototypical information-handling applications process 
structured information that has some form of hierarchical and'or modular structure. 
In one embodiment, image and word processing applications are not examples of 
25 what we term information-handling applications. In another embodiment of the 
present invention, structured information in bulk form does not include plain text or 
specific electronic media files such as MP3 files, 
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A conventional information handling application such as a graphing program 
comprises two major components: one component handles the intake of information, 
from storage devices, the network, or user input, and the other component handles the 
display of the information. There may also be parts of the application that perform 
5 computations or transformations on the information before it is displayed From the 
developer's perspective, a modular piece of software that handles a portion of (or all 
of) the data intake function is a data source component, because it provides 
■ information to other components within the application. A modular piece of software 
that handles part of (or all of) either the computation, transformation, or display of 

10 information is a data consumer component, because it uses (consumes) information 
provided by the data sources. 

Data sources and data consumers communicate with each other by making 
function calls. The particular functions and their parameters are defined as part of an 
internal version of an application program interface (API). The data consumer 

15 components handle data that is given them through specific calls on their respective 
API, so that information provided through data source components written for 
different applications will not be accepted. This situation provides little opportunity 
for reuse of data source or consumer components, since each is written to interoperate 
only with a specific instantiation of the other. 

20 In an embodiment of the present invention, an internal mediation layer is 

inserted between the data source components and the consumer components that 
expose data structure in a standardized way. Consumer components are constructed 
to use this common API, which is suitable for expressing an extremely wide variety of 
information types- Data source components can be constructed to deliver the 

25 information they take in this format, or a small amount of code can be written to 

translate the output of another source component into the common format The result 
of the construction is that any consumer component can work with any data source 
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component regardless of the specific nature of the information involved, or whether 
one was anticipated during the design of the other. The common API allows 
consumer components to automatically extract whatever features of information from 
a particular source they are most suitable for displaying or computing with, and also 
5 allows them to utilize all the other features of that information in a generic, 
unspecialized fashion. 

Other embodiments of the present invention comprise: (1) a system for 
representing information such that: (a) a single fixed interface suffices to describe a 
wide range of information types, (b) the information is rendered self describing to an 

10 extent, and (c) relationships between different information elements are expressed; (2) 
an apparatus for allowing this information representation to be employed as a medium 
between data source and data consumer software components; (3) a method and 
apparatus for attacliing clarifying material on "intended use" to information so that 
consumer components can handle it more appropriately; (4) a method and apparatus 

15 for providing a context to all information consumption affording control over security 
and visibility of data; (5) a method and apparatus for allowing users to transfer 
information from one consumer component to another through intuitive "drag and 
drop" and "cut and paste" interfaces; (6) a method and apparatus for developing 
enhanced information handling applications based on the foregoing framework; (7) a 

20 method and apparatus for automatically re-representing data from partially self 
describing sources including relational databases, XML streams, and Java software 
objects; (8) a method and apparatus allowing end users using computers distributed 
over a network to collaboratively view and manipulate information; and (9) a method 
and apparatus allowing software components distributed over a network to 

25 automatically obtain annotations on intent and other aspects of encountered data. 
Most aspects of this invention can be implemented in any object oriented 
programming language such as Smalltalk, Objective C, C++, or Java. Certain aspects 
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of it, pointed out below, are especially suited to object oriented languages such as 
Java and Objective C that provide for run time self analysis by programs. However, 
these are in every case peripheral aspects, and the essential parts of the invention may 
be implemented in an object oriented language like C++ without these capabilities. 
5 We will from time to time make reference to a "preferred embodiment" implemented 
in Java, but this should not be taken to be limiting. 

In a preferred embodiment the present invention provides a system and/or 
framework of software components for purposes of aiding development of 
information-handling applications. The system and/or framework of object-oriented 

10 software components aid the development of applications that read, gather, or receive 
electronic information and allow the display of such infonnation to and manipulation 
by users. These applications are structured in a way so that there are distinct data 
source components and data consumer components. The crucial features of the 
system and/or framework are the fact that data is seen by consumers only through a 

15 standard, conventionalized interface that incorporates: a breakdown into attributes, 
relationships, semantically-annotated "domain methods", event-broadcasting of 
changes in the foregoing to all registered consumers, metadata for each attribute 
providing certain declarative and procedural infonnation including unit of measure, 
content length, data quality, default value, comparator function, summary function, 

20 validation function, and input/output functions for display and user editing within an 
extensible set of interface modalities, related data items available for each data item 
including those in child or generic relationships, and including the ability to store a 
reference without direct access to the related item itself (it can be reconstructed if 
needed), and contextualization such that the attributes, relationships, events, and 

2$ methods available for a data item depends on context (see below). 

In a related embodiment, the system and/or framework includes methods for 
data exposure wherein the system determines automatically which method is 
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employed in any particular case, and the choice is invisible to consumers. Exemplary 
methods such as, a data source component which directly provides the standard 
interface, a data source component which is accompanied by a separate Translator 
component which maps its interface to the standard interface; and a data source 
5 component which is automatically inspected by the system to determine what 
available data fields it has, these are exposed to consumers through the standard 
interface as detailed above. 

In a preferred embodiment, the contextualization provided by the system 
and/or framework is accomplished by delegating die final responsibility for data 

10 exposure to an object termed an "JxtfoModel" which is able to choose which of the 
available attributes and methods on an object should be exposed or hidden, and is able 
to add additional attributes or methods. Preferably, the system and/or framework 
further provides facilities supporting transfer of data items between consumers, either 
by user manipulation (cut/paste or drag/drop) or by internal method calls. . When a 

15 transfer is initiated, the data item is passed without its contextual characteristics 
. (supplied by an InfoModel) to the receiver. The system and/or framework includes 
facilities supporting the automatic integration of service components (generally 
comprising management facilities such as menu provision or running of user dialog 
routines and may or may not have data source provider and/or user interface provider 

20 components) into an application. Integration is handled by a plug-in manager obj ect 
and set of interfaces such that: each service provider is given the opportunity upon 
loading to query all components (data providers or consumers) existing within the 
application for whether they desire the service, and if so what parameters they would 
like to pass to it. The provider then acts on these responses. Whenever new client 

25 components are loaded, they will be queried and possibly responded to by all services 
loaded within the application. 
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In another embodiment a system for importing partially schematized or 
structured data sources (such as a database system or an XML document) into a 
system as described herein. Any application written using the disclosed system 
and/or framework can then utilize these data sources through a standard interface. In 
5 particular, a system and/or framework for performing all or a substantial portion of 
the functionality outlined herein - if it is in connection with a framework or 
application implemented using a framework falling under categories as disclosed such 
as an infrastructure for mediating between information sources and consumers and 
rapidly assembling applications using them. 

10 Thus the present invention provides a method and apparatus involving two 

subsystems, one which processes the schema information for a data source to 
determine the type and metadata information for information attributes from the 
source, and one which processes the instance information. Preferably, the schema 
subsystem processes schematic information such as the type information contained in 

15 an XML schema document or the column information available from a relational 
database management system and sets up appropriate metadata and relationship 
structure for information elements, but it does not necessarily create any information 
elements- Optionally, additional annotations can be provided by a user in the form of 
a file specifying how to map attributes in the original data to metadata, relationships, 

20 or domain policy attribute or method definitions. Preferably, the instance subsystem 
processes instance information such as that available from an XML document or. set 
of relational database rows, for which corresponding schema information can be 
found, and constructs information elements exposed through the standard interface. 
Data consumers can utilize the outputs of these as if they were custom-created data 

25 sources for the type of information described in the schemas. 

In a related aspect, implementation of the invention as described herein for 
both XML and relational databases is provided In the XML implementation, a built- 

17 



WO 02/46916 



PCTMJS01/48418 



in data type hierarchy for XML schemas is used to provide types to attributes, and the 
element-subelement-attribute structural hierarchy in XML schemas is used to 
determine relationships between information elements. All documents and schema 
references to other documents are followed up to their sources in order to specify 
further attribute or relationship information. A user can optionally specify an XSLT 
(XML Stylesheet Transformations) document that maps the typed data fields found 
from the instance-schema combination into attributes with richer metadata and/or 
references to specific domain policies. In the database implementation, the table 
column heading types from the relational database (date, integer, text, etc.) are used to 
provide default type metadata to the attributes of information elements derived from 
table rows of the database. A user can optionally specify a mapping between columns 
or sets of columns into attributes with specific metadata. Furthermore, a user can 
define a sequence of queries for which the results are to result in a hierarchy of 
information elements. For example, for each information element retrieved from, for 
example, Query 1, a parameterized instantiation of Query 2 may be applied to retrieve 
elements which will be exposed as the children of the first information element. For 
each of these elements, a parameterized instantiation of Query 3 may be instantiated, 
and so forth. 

Framework Block Diagram 

Figure 1 shows a basic block diagram of a framework that is implemented in 
accordance with the present invention. The framework 100 of Figure 1 can be used to 
develop, for example, an information-handling system or application wherein data 
source components 102 and data consumer components 122 are separate and 
independent from each other but can communicate and share data. The framework 
100 described herein shall be called the extensible information system (XIS) 
framework. 
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From a developer's perspective, a modular piece of software that handles part 
or all of the data intake or retrieval function is a data source component 102. A 
modular piece of software that handles part or all of either data computation, 
transformation, presentation, or display of information is a data consumer component 
5 122. A conventional information-handling application such as a graphing program 
comprises two major components: one side handles the intake of information from 
storage devices, the network, or user input, and the other side handles the display or 
presentation of the information. There may also be parts of the application that 
perform computations or transformations on the information before it is displayed. 

io XIS Framework 

In the XIS framework 100 constructed in accordance with the invention, there 
may be more than one data source component 102 (also referred to as a source, data 
source, source component, and source object) and there may be more than one data 
consumer component 122 (also referred to as a consumer, consumer object, consumer 

15 component, and data consumer). The data source components 102 provide 

information to other components within the XIS framework 100 via a mediation layer 
1 12, while the data consumer components 122 use the provided information. 

The source components 102 and consumer components 122 that comprise the 
XIS framework 100 are configured such that they communicate with each other in a 

20 manner that is supported by the programming environment in which the framework 
exists, typically by making function calls, via the mediation layer 1 12. In one 
embodiment, the mediation layer 112 consists of a group of application programming 
interfaces (APIs) or class libraries that define a common format for data exchange, 
establishing an information exchange standard. Thus, data source components 102 

25 configured for a different system, application, or framework may still be used within 
the XIS framework if they are "wrapped" in a predetermined way or are suitably 
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modified, as will be known to those skilled in the art, such that they conform to the . 
requirements of the data exchange interface of the mediation layer 1 12. 

A relatively simple block of programming code may be produced to translate 
the output of a data source component 102 into the common format as defined by the 
5 . mediation layer or API 112. In this way, any consumer component 122 may work 
with any data source component 102 regardless of the specific nature or type of 
information involved and regardless of whether the data source component was 
known or anticipated during the design of the data consumer component. Because of 
the XIS framework described herein, the data consumer 122 may also extract 

10 whatever features or sets of information that it needs or can process from one or more 
data source, thereby enabling the data consumer to utilize features and information in 
a generic unspecialized fashion. 

The mediation layer 1 12, which is between the data source components 1 02 
and the consumer components 122, exposes the data structure of the data source 

15 • components 102 in a manner that is common for the framework, preferably through 
: an API interface. Data consumer components 122 are constructed to use this common 
API, including utilizing the exposed data structure. The data consumer components 
122 are suitable for expressing an extremely wide variety of information types. In 
addition, the data consumers may be constructed to deliver the information received 

20 from the mediation layer to another data consumer component, or to output the 
information received for display. 

Data consumer objects 122 are application or software objects or components 
that use data, or may be said to consume it Examples of data consumers include 
display programs that display data in tabular format, in graphical mode, in 

25 • organizational chart mode, spreadsheet mode, timeline mode (similar to files in the 
format of the "PROJECT" application from Microsoft Corporation), and the like. 
Data consumers may be desktop based, web-based (Internet-based), distributed 
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architecture, interpreted programs, and the like. Data consumer components within 
the XIS framework may provide display, computational, or interactive facilities. In 
the present description, such specially configured data consumer components are 
referred to as 'TNFOBEAN" objects, as available from the assignee of the present 
5 invention, Polexis, Inc. of San Diego, California, USA. Those skilled in the art will 
• understand how to extend fee framework 100 to produce desired applications, in view 
of the description herein. 

Figure 2 shows additional details of the mediation layer 1 12 in the framework 
1 00. In the framework 100, four special types of interfaces may be exposed to the 

10 data consumer components 122. These four interfaces include Domain Definition or 
Domain Policy 202, Relationship 210, Attributes/Metadata 214, and Change Event 
216- In one embodiment, change events are registered within the XIS framework 100. 
These interfaces may be exposed, for example, through class and object libraries that 
may be developed for the XIS framework. With these pre-defined class and object 

15 libraries and APIs, developers of data . source components 102 and data consumer 
components 122 may independently develop their own source and consumer 
components, thus facilitating development of information-handling applications or 
systems. An example of a class that may be implemented or written in the mediation 
layer to facilitate development of source and consumer components is illustrated in 

20 Figures 33 A to 33P, which show details of a sample class called ContentlnfoBean. 
Domain definitions or policies 202 (also referred to as domain objects or 
simply domains) are optional within the XIS framework 100. If defined, the 
corresponding Domain methods 212 for such policies are exposed to the data 
consumers 122. Other information about the domain policy may also be exposed, 

25 such as Attributes/metadata 214 and Relationships 2 10 for that particular Domain 

Policy. Attributes/Metadata 214, Change Events 216, and Relationships 210 may also 
be exposed within the XLS framework 100, even if domain policies are not defined. 
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Relationships show the relationship between data source components* 
Containment, hierarchies, and ad-hoc relationships, for example, may be shown. 
They may be expressed as "members of and references. Relationships are thus 
recognized and may be obtained accordingly, as shown in Figure 14 described further 
5 below. 

Change events may be used to ensure that all consumer or source components 
that have an interest in another source component's data are notified when changes 
occur. Changes may be notified when attributes, members (or containers), or 
references (or referrers) are added, updated, or removed and when values are changed. 

10 Once a data consumer component 122 obtains a reference to a data source 102, 

the data consumer component may obtain access to these interfaces 202, 210, 212, 
214, 216 through method calls in accordance with the programming environment of 
the host computer system. The data consumer 122 obtains such a reference typically 
in preparation to consume or use information from at least a particular data source 

15 102. Examples of such consumer component method calls include: 
get attributes; 

get member and container information elements; 
get referred and referring information elements; 
get unique ID and selection state; 
20 - add and remove instance specific attributes; 

register to be informed of changes to attributes or relationships; 
and 

invoke method calls of a semantically annotated type, described 
below. 

25 These types of method calls will be familiar to those skilled in the art and familiar 
with the programming environment of the host computer system. 
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Figure 3A is a schematic diagram showing the information about data source 
objects that is exposed by the mediation layer 1 12 in Figures 1 and 2, as well as the 
services available within the XIS framework 100, In accordance with the invention, 
data source components are wrapped with an object that exposes the interface 
5 information for the data source to data consumers through the mediation layer. 

In the preferred embodiment, the wrapper around each data source is an object 
provided by a class called InfoModeL As shown in Figure 3 A, a data source 
comprising a raw data item 351, via the APIs 1 12 as described above, offers a variety 
of information, as shown in the blocks 354, 356, 358, 360 5 362, through which data 

10 consumers may gain access to the data source. The information represented by the 
blocks 354, 356, 358, 360, 362 is exposed or may be contained within an InfoModel 
350, which provides an information space for all information available in the XIS 
framework 100 for the wrapped data source component. In one embodiment of the 
invention, the data needed by data consumers are accessed via such InfoModels (such 

15 as further illustrated in Figure 28). The wrapper provided by the InfoModel is called 
a LeifDataltem object 352. Thus, the InfoModel is an interface that permits data 
sources and data consumers of the XIS framework to independently share their data. 
In this way, the methods 360, domains 358, metadata 354, relationships 356, and 
other information of a data source object are thus exposed using the InfoModel object, 

20 which may be said to exist in the mediation layer 112, which sets up contexts for data 
consumption. The XIS framework also provides additional data services through the 
mediation layer, such as the Plug-In Service 264 and BeanContext Service 266 
indicated in Figure 3 A. These services provide the functionality listed in their 
respective boxes 364, 366. Other data services may be provided, as desired. 

25 The InfoModel object provides a context for information access, i.e., context is 

instantiated through the InfoModel concept. In this way, security may be enforced, 
considering that the conceptual or real "end-user 1T accessing the information is known 
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and thus the underlying data source may be forwarded correctly. Furthermore, 
through this InfoModel concept, an embodiment of the framework may be 
implemented such that attributes and methods may be added or removed by the 
framework user. Original attributes and methods in one context may also be 
5 overridden. 

An attribute is any property of an object In one embodiment of the invention, 
an attribute may be coded with an ,, AttnT>uteDescriptor*\ An AttributeDescriptor is 
provided by the object or its Translator to describe a property of the object using 
TypeMetaData, e.g., how to display it, how to edit it, its permitted ranges, and the 

io like. Translators map data source-specific structures and types to an XlS-generic 
representation. Translators are further discussed below. Attributes may also be 
defined using Java introspection or reflection, as discussed further below. 

Dynamic attributes may also be exposed within the XIS framework 100. 
These attributes are attributes that are exposed during run time, such as, for example, 

15 a database query wherein each column is an attribute revealed at run time. The 
mediation layer has a mechanism that captures such information. In the preferred 
embodiment, the XIS framework operates in conjunction with a database management . 
application, so that the mediation layer utilizes run time database query mechanisms 
that generate metadata of the data object, such as data table column headings, data 

20 types, and the like. Such mechanisms may be provided, for example, by SQL queries 
and the like. In one embodiment, data consumer applications using the XIS APIs are 
unaware of whether an attribute for a data item is obtained dynamically or statically, 
so that the process is transparent to the application user. 

A domain is a collection of semantically meaningful attributes and method 

25 signatures grouped by their common domain of interest Examples of domains 

include a Display Domain (a domain that describes how to display information) or a 
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Geo Domain (a domain that specifies how to handle geographic information). 
Domains are further discussed below. 

The contextualization provided by the XfS framework system is accomplished 
by delegating the final responsibility for data exposure to an object termed an 
"InfoModel", which is able to choose which of the available attributes and methods of 
an object should be exposed or hidden, and is able to add additional attributes or 
methods. Preferably, the system and/or framework further provides facilities 
supporting the transfer of data items between data consumers, either by user 
manipulation (cut/paste or drag/drop) or by internal method calls. This supports data 
sharing among data consumers. When a transfer is initiated, the data item is passed 
without its contextual characteristics (which are supplied by an InfoModel object) to 
the receiver, i.e., only non-contextual information is transferred. In this way, the 
source data may remain unchanged. 

As illustrated in Figure 3A, a FieldMetaData file 354, a type of metadata, is 
used to represent sorting, subset, and visibility criteria for an attribute. This is further 
explained below in conjunction with Examples 1 to 5, wherein subsets of data are 
shown depending on whether "AH Attributes" or "Preferred Attributes" are shown. In 
one embodiment of the invention, default behavior method of domain policy attributes 
may also be overridden. Within this framework, context-specific special attributes for 
flagging whether a data item should be visible or not (e.g., can be used for display 
filtering, including the XIS value slider, tree checkboxes in the map view, etc.) may 
be defined. This may be achieved through the mediation layer by utilizing a user 
interface to modify display processing for the data item. Furthermore, a selection 
attribute that is a context-specific special attribute for flagging whether an object is 
"selected" (and typically should be highlighted) may also be defined. Selected pieces 
of information are often shared among views (context-specific, though), and certain 
operations may be performed on the set of selected objects in a given context 
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The InfoModel objects as described above know how to return a data item (a 
LeifDataltem) given a corresponding raw data source identifier- The InfoModel also 
manages these data items. As indicated in Figure 3 A, an InfoModel may contain one 
or more LeifDataltem objects, each of which provides an interface to a raw data item. 
5 An application developer may use an InfoModel object 350 to get a LeifDataltem 
object 352 in order to use the XIS APIs for accessing the underlying data source in a 
generic fashion. If two different data consumer components ask for a data item (e.g., 
a LeifDataltem) from the same InfoModel for the same raw data source, then both 
data consumers will get the same instance of the LeifDataltem object. InfoModel 

10 objects may also be nested as indicated in Figure SB- 
Information becomes normalized in the XIS framework so that any application 
can use an object's information by getting attributes and relationships dynamically at 
runtime. Therefore, instead of hard-coding a visualization program to a specific type 
of object, the visualization looks for the attributes it needs to perform its function. 

15 Thus, the developer of the data consuming module may obtain the information needed 
from the XIS LeifDataltem class, which wraps raw data item objects and exposes 
them to the data consumer through uniform APIs. The visualization can access all the 
information exposed, through the XIS APIs and techniques, as needed If the data 
source provides AttributeDescriptor objects or translates the properties to domain 

20 attributes, then the information can be interpreted more intelligently in domain- 
specific ways. In one embodiment of the invention, the XIS framework also offers 
APIs and a programming model (or design pattern) that extends Sun's JavaBean 
pattern with XIS information awareness. These extended JavaBeans comprise 
"smarter JavaBeans" that are provided in the XIS framework as the specially 

25 configured INFOBEAN objects and, like JavaBeans, INFOBEANs can be visual or 
nonvisual components, and can be graphically combined in any standard Java 
development environment. 
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InfoModel Class Objects 

In one embodiment, there are four types of InfoModels in the XIS framework: 
BaselnfoModei : * 

A single BaselnfoModei is required because it is responsible for creating and 
caching every BaseDataltem (data item) wrapping a Java object (the raw data item 
object). The BaselnfoModei object holds any object used as a LeifDataltem until the 
data item is no longer needed (i.e., until it is no longer strongly referenced). 

SelectablelnfoModel : 
' A super class of BaselnfoModei, this InfoModel delegates to any other 
InfoModel (typically the BaselnfoModei), and creates SelectableDataltems (data 
items that are selectable). The SelectablelnfoModel objects add a selected Boolean 
attribute and delegate to the LeifDataltems from the prior InfoModel. Since the 
BaselnfoModei is a SelectablelnfoModel, all LeifDataltems have a selected attribute. 
This is true because any LeifDataltem is either in the BaselnfoModei itself; or is in an 
InfoModel that is nested in the BaselnfoModei and, therefore, inherits the selected 
attribute from the BaseDataltem. Additional SelectablelnfoModels can be 
instantiated to create independent contexts for selection state, independent of other 
InfoModels. 

AttributeFactorylnfoModel : 

This InfoModel allows AttributeFactory classes to be registered so that every 
time a LeifDataltem is created, it enables attribute factories to add additional 
attributes to each LeifDataltem. 

InfoModelSubset : 

A super class of SelectablelnfoModel and AttributeFactorylnfoModel, this is 
the simplest InfoModel. It delegates to its parent InfoModel and creates 
LeifDataltems that wrap those XIS data items from the other InfoModel. This 
InfoModel does not automatically add any attributes to the LeifDataltems it creates 
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and manages, but simply provides a context in which data items can be managed. 
Each InfoModel "layer" provides a context in which additional attributes can be 
defined, or existing ones can be overridden. Figures 34A to 34D list an exemplary.. 
Java package that lists various classes. Figures 35A to 35D list the InfoModel 
5 interface. An interface is a contract in the form of a collection of method and constant 
declarations- When a class implements an interface, it promises to implement all of 
the methods declared in that interface. 
Exposing Data 

Figure 4 is a diagram showing how information from source components may 

io be exposed to data consumers using the mediation layer 1 12. The Attribute/Metadata 
interface 214 of Figure 2 exposes a data item 440, 442 as a set of attributes, each of 
which carry a value and a set of metadata that describes the value. A data consumer 
component 420, 422, 424 may obtain information from one or more data items. 
Similarly, a data item 342 may be used by more than one data consumer 422, 424 via 

15 'the mediation layer or API 1 12. The information blocks 460, 461 show the 
information available to data consumers, 

A data source component 102 may comprise a data source interface (DSI) 
object 412, 414. A DSI object 412, 414 provides a conceptual way to encapsulate 
objects that provide data to the XIS framework 100. A class of a DSI object does not 

20 have to extend or implement any interface. Data is created (instantiated) in DSI 
objects to thereby encapsulate the data and make it available to other objects. The 
DSI itself may also be a data item that simply contains other data items (members). 
The data may be generated internally or extracted from an external source such as a 
database or across a LAN. In addition to creating the data, DSI objects are also 

25 responsible for maintaining and controlling data, such as removing and updating the 
data themselves if such changes are observed in the underlying data used by the DSI 
to create the data. Property change events (216 of Figure 2) may be used by DSIs to 
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communicate changes observed in the original source data items to the listening data 
consumers. 

Any Java object may be a data source component. The Swing JButton, for 
example, is usually a transient object, and not typically retrieved in an infonnation 
5 system. The Swing JButton, however, may still be a data source, if so desired. 

INFOBEANs as stated above are data consumer components 420, 422, 424. 
They are specially configured objects that behave like JavaBeans that process and 
manipulate data in a generic fashion. They are also capable of interpreting and 
optionally displaying XIS data items. INFOBEANs use the XIS framework API's to 
10 gain access to information about data items. 

As previously stated, any Java object may become a data item 440, 442 within 
the XIS framework 100. To make a data item out of JSlider (javax.swing JSlider), it 
simply must be added to an INFOBEAN (data consumer component). Table II below 
provides programming code that makes a data item out of javax.swing. JSlider, thus 
1 5 exposing the information blocks 460, 46 1 shown in Figure 4. 



Table n 

Jslider slider ~ new Jslider(0, 100,50); 
tableInfoBean.addRawDataItem(slider); 



The first line of code creates a data item out of JSlider. The second line of 
code adds the JSlider created in line 1 to the TablelnfoBean object (an INFOBEAN). 
20 In this framework, JSlider knows nothing about the XIS framework, however, all its 
attributes are exposed, to be used and modified. 

There are basic steps that must be performed when creating a DSL First, 
before any code is actually written, a determination must be made as to how the 
original data or data source is to be obtained (e.g., will it come from a database, a flat 
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file, an EJB (Enterprise JavaBean), read from a socket, etc.). This step is performed 
prior to and independent of coding the DSL Once the data source has been 
determined, it must be decided what attributes of the data source should be exposed 
within the XIS framework. 
5 The DSI component within the mediation layer of the XIS framework has the 

capability of exposing the attributes of a data source, in one embodiment, assuming 
that the data source is a Java object, the attributes to be exposed are determined 
through Java introspection. Introspection is a way to determine a bean's properties, 
methods, and events. Those skilled in the art will understand that a bean is a reusable 

10 software component, which may be combined to build applications. In this scenario, 
no additional code in the consumer component needs to be written. Although 
convenient, this approach is limiting, as it does not allow control over which attributes 
are exposed, and does not allow the user to define custom visualization components or 
express semantics. Furthermore, it requires the Java object to conform to the 

15 JavaBean design pattern. 

Another approach to determining which attributes of a data source should be 
exposed involves writing new code. This approach embeds XlS-aware code directly 
into the Java object. This allows the component developer to directly specify details 
such as the attributes (e.g., via AttributeDescriptor) to be exposed along with their 

20 metadata, the Domains to which the DSI subscribes, which Domain methods are 
exposed with what implementations, and more. Writing new code enables greater 
control over the data item (as opposed to the introspection-only case) and provides 
more flexibility in dealing with any Java object rather than just JavaBean objects. 
One limitation of this approach is that the relationships between data items may not be 

25 directly specified. 

Another approach for exposing attributes is to create a Translator class. An 
application developer may place any of the XlS-aware code for exposing attributes, 
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Domains, and the like in this class, as specifying relationships to other data as 
members or as references. This is described further below, in conjunction with the 
description of Figures 21 to 23. 

Referring back to Figure 4, a data consumer 420, 422, 424 may access a data 
5 source via a data source interface (DSI) object defined in the mediation layer 1 12. 
Communication between the DSI objects 412, 414 and data consumers 420, 422, 424 
in the framework 100 is mediated through a set of application programming interfaces 
(APIs) 1 12 that remain independent of the actual contents and types of the data 
sources. Such APIs are contained in class libraries. 

10 Using the framework 100, a data consumer 420, 422, 424 (for example, an 

INFOBEAN as shown in Figure 6B) may be able to use heterogeneous data sources 
and, thus, eliminate the need to write a particular display software object for each 
particular data source. Within this framework, any data consumer object or 
application may use the data source object's information by getting attributes and 

15 relationships dynamically at run time. Instead of hard coding a visualization to a 
specific type of data source component, the visualization object or data consumer 
looks for the attributes it needs to perform its function. Thus, in this framework, 
developers for source and consumer objects may work independently of each other. 
The DSI object may create any data structure containing members and 

20 references, and may expose any part of that data structure to the framework or system 
100 if it is desired Since there are no requirements involved to be a data source, a 
visualization bean can also be a data source. The data source can consume data from 
other data sources, and can create new data based on what it has learned. For 
example, DSI objects may be coded to use data source from an RDBMS, e.g., systems 

25 such as provided by Oracle Corporation of Redwood Shores, California, USA and as 
provided by Microsoft Corporation of Redmond, Washington, USA through their 
"ACCESS" application or SQL Server. DSI objects also may use data sources such as 
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XML format data, tabular data (e.g., spreadsheet data such as spreadsheet files in the 
format ofthe "Excel" application from Microsoft Corporation), email, schedules (e.g. 
schedule data in the format ofthe "PROJECT" application from Microsoft 
Corporation), data following the SNMP (simple network management protocol), and 
5 the like. 

Objects created by DSIs are considered to be raw objects in the XIS platform. 
These raw objects become normalized objects within the XIS framework when they 
conform to the mediation layer or the API 1 12. In one embodiment, when these raw 
objects are added to an XlS-enabled environment, the XIS framework wraps them 

10 with a normalized object called a LeifDataltem (see Figure 3 A) and holds the data 
item in one or more InfoModels. The raw data item could be a simple Java object 
(that does not know anything about XIS) or it can support XIS with direct references 
to AttributeDescriptors and other metadata that are recognized by XIS. The 
mediation layer is implemented in software and runs in-process. It is also exportable 

15 to serve as a distributed middleware if required by a given application. 

An attribute is any property of an object. An attribute 474, 475 typically 
includes identity (ID number) 476, 477, name ofthe attribute 478, 479, value 480, 
481, and the metadata type or Type Metadata 482, 484, and a description 484, 485. 
Attribute names 478, 479 may be the table column header or field name in an 

20 RDBMS. The description ofthe attribute 484, 485 may be plain text that explains the 
attribute. The value 480, 481 may be expressed as a number, string, or other basic 
data type, or may be expressed as a complex, structured object in itself. 

Referring back to Figure 2, the Attribute/Metadata interface 214 provides for 
fine-grained exposure of an information element or data item 440 442 (Figure 4); by 

25 "fine-grained" is meant that the data item is broken down into a number of aspects or 
characteristics (the "attributes") which are simpler data elements. These might be 
numerical values, strings, arrays, or anything else that can be represented by a 
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software object (but is simpler than the original element). If a data consumer 412, 
414 is not able to handle the entire data element, it may be able to handle some of its 
attributes and therefore may be able to do something useful with it, unlike most 
systems providing interfaces for data integration, which require the entire interface to 
5 be implemented to enable any data usage. 

The Attribute/Metadata interface 214 also makes each attribute self-describing, 
to a limited extent. In accordance with the invention, a data consumer designed 
without regard to a particular type of attribute is still able to display and perform 
limited operations with those attributes by using the metadata types. For example, a 

10 data consumer object or INFOBEAN, which displays an X and Y chart of cost of 
living (expressed as a numerical value) versus geographical location (expressed as a 
territory or state character string, e.g., "California 11 ), may be used to display a different 
set of data contained in another data source component or data item, so long as the 
metadata types of the different sets of data are compatible with the X and Y chart In 

15 particular, a data consumer component that renders and edits information may still be 
executed, the default value substituted in cases of absence, and statistical 
summarization performed, even if the data consumer component is processing a 
different data source component Other operations are possible and additional 
metadata may be provided by developers for any identifieiclasses of information 

20 elements (such as number, array, geographic entity, etc.) desired. Because of this, 
data consumer developers may identify the type of auxiliary information or 
procedures provided by the consumer component and then define the interface 
according to which other developers creating data sources should provide or expose 
their metadata. 

25 In one embodiment, any property or attribute of an object may be defined with 

an AttributeDescriptor programming code. When a data source object is enabled 
within the XIS framework, the computing system automatically creates 
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AttributeDescriptors for JavaBean properties and for some public properties. A 
JSlider object, for example, is a JavaBean. JavaBeans have properties that are defined 
by the get<property> and set<property> methods. If the object is a JavaBean and 
provides a Beanlnfo, then it will be honored and treated according to the JavaBean's 
5 specification for Beanlnfo classes. Only properties listed in the Beanlnfo appear as 
attributes. If metadata types, further discussed below, support the property's type, 
then they appear as attributes for that data item. Any properties that do not have 
TypeMetaData support become data items themselves (using the same reflection and 
introspection rules) and are listed in the data item's reference array, retrieved by the 

10 LeifDataltem getReferencesO method (i.e., a method to obtain the references); 

Translators translate various data item classes, thereby enabling seamless integration 
of various data items without code modification. Translators may also be added to 
augment object reflection and introspection, i.e., by developers directly specifying the 
properties of an object 

15 Table III below lists exemplary programming code to define attributes. Table 

HI shows how to define a SIZE attribute. 



Table HI 

public static AttributeDescriptor SIZE; ~~" 
static { 

AttributeDescriptorFactory factory — 

AttributeDesraptorFactoiy.get 
SIZE = factory.createAttributeDescriptor( 

"size", Yourxlass, 

new NumericTypeMetaData("Size", long.class, 
UnitsOfMeasure.BYTES, 6)); 
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} 



Metadata are data or information regarding data, for example, data type, field 
name, lengthy value restriction, color, and the like. In practice, metadata are used to 
5 define the structure and meaning of data objects in tools, databases, applications, and 
- other information processes. The data type metadata 482, 483 encompasses both 
procedural and declarative information, including (as appropriate for the value) but 
not limited to the following: 

10 - unit of measure (from the provided unit of measure software 

object, converters to/from other units are accessible); 
content length; 

default or maximum character length or precision of numbers; 
data quality (a rating given by the provider of the data); 
15 - default value (given by the provider of the data type); 

constraints (e.g., numeric range or list of acceptable values); 
formatting; 

comparator function (a procedure which takes two items of the 
data type in question and returns whether one is to be ordered 

20 before, after, or the same as the other); 

validation function (returns 'true' or 'false 1 depending on whether 
the value for the attribute passes a certain test or set of tests, tests 
are developer-definable based on an interface which takes a 
software object providing a value and returns a Boolean value, 

25 but several reference implementations are provided, such as one 

to determine whether a number is within a specified range; 
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list of applicable summary (statistical) functions, summary 
functions are developer-definable based on an interface which 
takes a collection or array of software objects providing values 
and returns a single value (usually, but not necessarily of the 
5 same type) based on those values, several reference 

implementations are provided, including mean, standard 
deviation, count, max, min, median; and 
renderer and editor procedures for different output modalities 
(examples of modalities include local graphical window, HTML, 
10 plain text, and WML). 

A renderer displays a value, while an editor allows the user to enter or edit one; 
Tenderers and editors are both developer definable for any modality desired. In the 
preferred embodiment, Tenderers and editors for graphical windows, HTML, and plain 

15 text are provided. 

In a simple example, a data item may have an attribute called "Manager" 
(attribute name) 478, 479 that has a value of " John Doe," 480, 48 1 with metadata type 
482, 484 of content length (e.g. "30"), data type ("string"), and default value (""). In 
another example, a data item may have an attribute called "Cost" 478, 479 that has a 

20 value of "5.00" 480, 481 with metadata type of datatype ("float"), default value 
("0.0"), summary statistics ("true"), validation function ("can never be less than 
zero"), and the like. 

The Attribute/Metadata interface specifies generic type accessors for object 
comparing, editing, formatting, rendering, and validation. This displaces the burden 

25 from the consumer of the data (TNOFOBEANs) to the developer of the TypeMetaData. 
It enables developers to use existing TypeMetaData to create content that is viewable 
in many forms such as a Swing Component, HTML table, and WML text. 
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In one embodiment of the invention, the data consumer components are very 
generic, requiring little or no Domain-specific knowledge. For example, a data 
consumer object, for example, which resembles a spreadsheet, displays all available 
attributes of any data item, regardless of the Domain Policies represented. If useful to 
5 this consumer object, the metadata types may provide graphical control components 
for rendering attribute values. They also may supply editor components that give the 
end-user a standard way to modify an attribute, e.g., a color chooser GUI for selecting 
a new color value. 

An input/out metadata class, TypelO, defines the end content format. The 
10 TypelO class offers flexibility in both the input (editing) and output (rendering) of 
attributes according to their type, In one embodiment, a TypelO object is registered 
for a specific TypeMetaData using a registry, for example, the TypelORegistry. The 
registration is performed on the following interface types: HTMLTypelO, 
SwingTypelO, TextTypelO and WMLTypelO. Examples of Type 10 are "Swing 
15 Type 10" (for Java standard user interface library called "Swing"), HTML (hypertext 
markup language), WML (wireless markup language), XML (extensible markup 
language), and text Swing is a graphical user interface (GUI) component kit, part of 
the Java Foundation Classes (JFC) that are integrated into the Java programming 
language. Swing simplifies deployment of applications by providing a complete set 
20 of user-interface elements written entirely in the Java programming language. Swing 
components permit a customizable look and feel without relying on any specific 
windowing system. 

Table IV below is exemplary code to register two different TypelOs for the 
BooleanTypeMetaData. 



Table IV 

static { 
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TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 

SwingTypelO.class, 

BooleanSwingTypelO.class); 
TypeIORegistry.registerTypeIO(BooleaiiTypeMetaData.class, 

TextTypelO.class, 

BooleanTextTypelO.class); 

} 



In one embodiment, the metadata type may be overridden. For example, it is 
possible to override the editing/rendering capabilities of a TypeMetaData. In one 
5 embodiment, a new TypelO implementation is registered that provides the desired 
editing and rendering. If a developer only wants to affect the TypeMetaData instance 
that the developer is using, a subclass must be created and the TypelO registered with 
that subclass. Thereafter, any instances of the new subclass will use the specified 
TypelO. 

10 Other features may also be added to the TypeMetaData, such as summary 

• function, min function, max function, and the like. For example, 
BooleanTypeMetaData adds summary methods for obtaining the total of false and 
true counts. Exemplary code to perform this modification is listed in Table V below. 



15 

Table V 

static { 

TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 
SwingTypelO.class, 
BooleanSwingTypelO.class); 
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TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 
TextTypelO.class, 
BooleanTextTypelO.class); 

} 

* Constructs a <b>BooleanTypeMetaData<Vb> with <i>name</I> 

* @param name the type name, returned by getName(). 
*/ 

public BooleanTypeMetaData(String name) { 
super(name); 

addSummaryFunction(new FalseBooleanSummaryFunction(this)); 
addSummaryFunction(new TrueBooleanSximmaryFimction(this)); 

> 



Methods may also be added to the TypeMetaData interface to provide standard 
behavior. Constraints may also be specified. Table VI below lists exemplary code to 
5 define a StringTypeMetaData called "Threat" with only three valid values 
("HOSTILE," "FRIEND," and "NEUTRAL"). 



Table VI 

new StringTypeMetaData("Threat", 3) { 
{ 

setValidTest( 
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new DiscreteRangeO { 
{ 

add("HOS"); 

add("FRI"); 

add("NEU"); 

} 

} 

); 

} 

} 



In one embodiment, an INFOBEAN data consumer is given a data item. The 
consumer examines the data item and its attributes, and may also access certain 
5 Domain attributes or execute Domain methods. If the consumer finds something it 
can use, the data item is further processed according to that consumer's function. For 
example, a user might drag a group of data items to an INFOBEAN that displays time 
relationships. The INFOBEAN would ignore those data items that did not have any 
appropriate time-related attributes. For those data items that have time-related 

10 attributes, the values can be obtained and used to populate a user interface. 

Referring back to Figure 2, the Domain Definition/Policy interface 202 
provides a means for the intended use of an attribute in a data item to be conveyed 
along with the attribute itself. A domain policy typically comprises a list of attribute 
types with metadata and a list of function calls applicable to data possessing some or 

15 all of the attributes with parameter specifications, annotated with English text 
expressing the intent (i.e., description of the attribute). It is a group of related 
attributes (or properties), along with their semantics to usefully deal with data 
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Two or more modules (consumer and source) may subscribe to the same 
Domain. This, however, does not preclude the modules to be developed 
independently. A Domain Policy in one embodiment is defined by Java classes that 
declare a set of attributes and methods that might be supported by a given data item. 
5 For example, a temporal domain defines start time and duration as attributes. A 
timeline may only be properly plotted if such software object understands which 
attribute represents the start time and which attribute represents the duration or the 
end time. For this to work in XIS, two classes would need to exist: TemporalDomain 
and TemporalDomain Wrapper. The TemporalDomain class defines the 

10 AttributeDescriptors (i.e., attributes) for each domain attribute; and the 

TemporalDomain Wrapper class provides accessor and mutator (get and set) methods 
for these attributes. The wrapper also may declare one or more domain methods, 
which can have any signature to be invoked with the data item as the target object. 
The wrapper is a convenience class for accessing domain attributes, providing 

15 optional default values, and invoking domain methods through Java reflection. 

Analyzing any domain yields a list of attributes and methods. Though much 
like a class definition in form, Domain Policies are supposed to convey and define 
logically independent characteristics related only by their domain context. It is very 
important not to fall into the trap of accidentally creating a domain that reflects a 

20 particular class or interface, or to add implementation-specific details that have 
nothing to do with conceptual domains into a given Domain Policy. An application 
can obtain and manipulate attributes of an object via a domain wrapper instead of 
accessing the object directly. This eliminates the dependency on the class of the 
object An application can now be written with only the knowledge of domains. No 

25 prior knowledge of a particular data source is required at development time, only 
domains. 
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In one embodiment, attribute aliases may be used. This enables one attribute 
to be substituted for another. This is typically used when two domains are defined 
that have similar attributes. This enables a consumer to ask for the Attribute from the 
domain that it knows about, and have the value translated from the Attribute of the 
5 DSI from the second domain. In one embodiment, the mediation layer implements 
this in a seamless operation, i.e., either the consumer or provider of the Attributes 
knows that it was an aliased Attribute, for example, "speed in knots" and "velocity in 
meters/sec". 

In another embodiment, methods of Domains may be registered with domain 

10 method descriptor factories similar to AttributeDescriptors. In this implementation, it 
enables developers to reference domain methods via these static singletons, determine 
if domain methods of interest are defined, and to determine all information about the 
argument types and interpretation of the domain method. Furthermore, like the 
attribute descriptor factoiy (AttributeDescriptorFactory), developers pass the 

15 necessary ingredients or information to this factory, and the factory handles the 
internal registration of the method parameter types, return type, exceptions, and 
interpretation. It ensures that one and only one object in the Java runtime exists for 
each distinct domain method definition (each unique method signature), similar to 
attributes and attributes factory. 

20 Figure 4 shows a schematic diagram of information that may be exposed by a 

data item 510 (440 and 452 in Figure 4). In an embodiment of the present invention, 
a data item 510 is defined as any unit of information that can be represented by a 
single object (perhaps containing subobjects) in an object oriented programming 
(OOP) language and is a coherent unit in terms of the semantics of the content domain 

25 that it relates to. Thus, data items are defined within a common semantic 

representation. Each information element is defined in terms of entities (data source 
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or data consumer component), identity, relationships, attributes (name/value), services 
(not just data), and change events (dynamic nature). 

For example, a single row in a relational database containing information on a 
person's name and address constitutes an information element, but so would the table 
5 from which it comes, and even the entire database itself. Different levels or 

granularity of information is useful in the context of different applications, but any 
one of them can be considered an information element for purposes of our exposition. 
An example of a noncoherent unit would be a random collection of name/address 
rows from a database, unless there was some comprehensible unifying characteristic 

10 to them (e.g., all rows for addresses in the state of Utah). 

Data items use Domain Policy attributes and methods to express the data item 
characteristics in a "normalized" maimer. That is, a data item may expose Domain 
Policy methods 512, which are the functions or methods 516, 518, 520 of a particular ■ 
Domain Policy to characterize the data item's behavior and attributes to characterize 

15 the data item's information content. A data item may also expose Domain attributes 
and metadata. A data item may also be part of more than one Domain Policy, thus a 
number of Domain methods 512 may be exposed with such data item 510. The 
Domain methods define the method name, possible input parameters, which may be 
mutable objects, i.e., input/output parameters, and optional return value. This shows 

20 the expected behavior of the method, expectations of the inputs, and return value 

constraints. The data item may also expose one or more attributes 530 and 538. Each 
attribute 530, 538 may have an attribute value 534, 542, an attribute descriptor 532, 
540 (containing, among other information, an English text description of the 
attribute), and type metadata 536, 543, The type metadata may include the class type 

25 544 (the class type of the attribute's value) and type input/output 546 (TypelO, for IO 
facilities). Examples of class type are LatLonAlt (for latitude, longitude, altitude 
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data), String (string data), Integer (integer data), Date (calendar date), Color, and the 
like. TypelO, as discussed above, may indicate the input and output format. 

The Relationships 522, e.g., containment, hierarchies, and ad-hoc relationships, 
of a particular data item 510 may also be exposed as shown by the data items 524, 
526, 528. A data item may have zero (none at all) or may have many data' 
relationships to the other data items via Domain methods and attributes. 

Additional information exposed by a data element is a metadata override, 
which may be used to override a default behavior of a Domain Policy attribute. For 
example, default formatting of a date for some Domain Policy may be overridden, 
from MM-DD format (two digits for month and two digits for date) to "month text 
string" and DD format In one embodiment, this may be implemented by assigning 
different metadata to an attribute using FieldMetaData within the XIS framework. 

User Interface 

Figures 6A to 6F are exemplary representations of computer display windows 
produced by data consumer components 122, which may be developed within the XIS 
framework 100. These data consumer components may use any data source 
component 102 for data and may also be run without an associated data source 
component. 

Figure 6 A shows a computer display window called "Map View 1" produced 
by a mapping program for an INFOBEAN object that contains vector shoreline data 
from a data source component to produce the world shoreline depiction in the drawing 
figure. If an appropriate data source is loaded into this INFOBEAN, then appropriate 
additional pieces of information will be displayed, e.g., as geographic points on the 
depicted world map. Appropriate pieces of information for this INFOBEAN may 
include numeric data, which may, for example, be mapped to a set of latitude, 
longitude, and altitude coordinates on the map display of Figure 6 A. 
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Figures 6B to 6D show window displays of a file manager or information 
exploring component, much like a file system explorer, called "XIS Explorer" with a 
vertically oriented directory frame on the left side of the window display and two 
stacked information detail frames on the right side. The directory frame on the left 
5 may provide a tree diagram of available DSI components and their relationships to 
other components. Figure 6B shows that the Explorer View display does not contain 
any data (the "Explorer Contents" menu is empty). Figure 6C shows the XIS 
Explorer program after it is loaded with data called "Orders", "Computer", and 
"People Source" data sources, with "People Source" selected. Detail information 

10 about the People Source data is shown in the two stacked right frames. The upper 
right frame shows a listing of data objects or entries in the People Source data source, 
and the lower right frame shows attributes of a particular data object in People 
Source. A different set of data objects or records is shown in Figure 6D, this time for 
the "Orders" data file. That is, Figure 6D corresponds to the Figure 6B display after 

15 XIS Explorer is loaded with the "Orders" data. Thus, detail information about the 
orders is shown in the two right frames. Figure 6D shows that a listing of data object 
names can be provided in the left tree diagram frame. As indicated by the display 
windows shown in Figures 6B to 6D, the same data consumer component or 
INFOBEAN-generated display format (Figure 6B) may be used to display different 

20 data source components (Figure 6C and Figure 6D, e.g., "People Source" and 
"Orders"). 

Figures 6E and 6F show a graphing program INFOBEAN display. Figure 6E 
shows the window display when it does not contain any data, while Figure 6F shows 
"Orders" (the same class of data objects shown in Figure 6D) loaded and displayed as 
25 a graph. This shows that the same data source component 102 may be utilized by 
more than one data consumer component to display different types of data 
characteristics and carry out different operations on the data, as shown in Figures 6B 



46 



WO 02/46916 



PCT7US01/48418 



through 6F. Thus, different INFOBEAN data consumer components can be 
configured to produce the desired data operations and window displays from available 
data objects (sources). 

Figure 7 shows a computer window display for an INFOBEAN data consumer 
5 component, showing the property sheet of a particular data source object called 
"Person." This "Person" object may be a Java object Those skilled in the art will 
understand that JavaBeans are a specification developed by Sun Microsystems that 
defines how Java objects can interact. An object that conforms to this specification is 
called a JavaBean. This object may be used by any application that understands the 

10 JavaBeans format. For example, the "INFOBEAN" objects available from Polexis, 
Inc. of San Diego, California, USA are objects that behave as JavaBeans that can 
process data in a generic fashion, looking for and manipulating data pertaining to 
particular domains as generated by DSIs or other INFOBEANs. 

Data consumer objects may also be Java objects that present and/or process 2D 

15 and 3D maps, table/spreadsheet data, hierarchies (trees), plots (bar, scatter, pie, etc.), 
gantt/timeline, content (e.g., email), organization charts, calendars, properties or 
attributes, and the like. 

Figure 8 shows a unified modeling language (UML) class diagram for a Person 
class source data. Using the XIS framework of the present invention, the data 

20 consumer, an INFOBEAN, obtains information, particularly, the attributes listed in 
Figure 7 (e.g., SSN, Display Name, DOB, and Name) of the Person object. This set 
of information is shown in blocks 460 and 461 in Figure 4. This is performed, for 
example, by using a naming convention for methods, i.e., GET + "Attribute Name." 
An API determines the available methods of an object and determines attributes based 

25 on method names. For example, an API from "getDOB," "getName," and "getSSN" 
methods determines the attributes DOB, Name, and SSN, respectively. Java 
introspection may also be used, 
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Figure 9 shows the different attributes obtained or exposed for the Person 
object (i.e., DOB, SSN, and Name). In addition, using the toStringO method, 
available for every object in Java, as shown in Figure 6, the DisplayName attribute is 
also exposed. 

In one embodiment, no Translator exists for the Person object. Also, there are 
no static get<PropertyName>Descriptor methods defined, so the only XIS Domain 
Attribute is the displayName that is obtained, by default, from the toStringO method 
available in every object in Java. The remaining attributes (date of birth, Social 
Security number, and name), though not mapped to a Domain, are available through 
the mediation layer API. 

If an XIS Translator were used or if the Person class specified XIS 
AttributeDescriptors, then the Java fields could be mapped to domains. In this case, 
for example, the birth date and Social Security number could be mapped to 
corresponding attributes in the "Personnel Domain". Within this domain, the 
attributes would be specified with detailed TypeMetaData, which is made available so 
that the data from the attributes, such as the Social Security number, can be 
appropriately validated, displayed, edited, formatted, and otherwise processed 
wherever that attribute is used. 

Figure 10 shows how an object, particularly a data source component, may 
belong to multiple domain policies. In this case, for example, the domain policies 
include the Geo Domain (geographical domain), Movement Domain, and Display 
Domain. The Geo Domain has defined at least two methods called GetLatLonAlt and 
SetLatLonAlt The GetLatLonAlt method obtains the latitude, longitude, and altitude, 
while the SetLatLonAlt method sets these parameters. The Movement Domain 
contains a GetCourse method, which obtains the course or direction of an airplane, for 
example. The Display Domain has two methods called GetDisplayName and 
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GetBrushColor, which obtain the name of the object and display the color of the 
object, respectively. 

Figure 1 1 shows a sequence diagram of a domain policy usage scenario. In 
this time sequence diagram, each column represents an entity (i.e., user display 1 102, 
5 data consumer component 1 1 04, and data source component 1 1 06), and time or 
sequence flows from top to bottom. Here, a data consumer software component 
(middle) requests a data source to tell it the Domain Policies to which the data source 
subscribes. Upon receipt of the information, the data consumer checks to see whether 
these include the Geo, Movement, and Temporal Domains, which it recognizes. The 

10 developer of the data consumer need not have known about this particular source, nor 
the data source developer known about the particular consumer, for these two 
components to interoperate correctly: the data consumer plots three numbers given to 
it by the source as position, speed, and a time duration (computed by a call to a known 
function on the source), as they were intended by the source's developer. In the XIS 

15 framework, applications and components that comply with the Domain Policy API are 
able to share data in a simple yet powerful manner, ensuring automated integration 
and reuse. Thus, data sources and data consumers may be independently developed. 

In one embodiment, attributes of a given domain are exposed through the static 
final AttributeDescriptors of that domain. The AttributeDescriptors that make up any 

20 given domain are built using the AttributeDescriptorFactory. If the developer of a 
data item class uses a custom AttributeDescriptor, then it should be built (typically in 
the Translator) using this factory. 

Table VII below shows exemplary code that illustrates how a DisplayDomain 
builds its font attribute. 



Table Vn 
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public static final AttributeDescriptor font; ■— — - — — 
static { 

AttributeDescriptor tmpFont = null; 
try{ 

AttributeDescriptoTFactory factory = 

AttributeDescriptorFactory.getAttributeDescriptorFactoryO; 
tmpFont = factory xreateAttributeDescriptor( 
"font", 

DisplayDomain.class, 

new com.xis.types.FontTypeMetaData('Tont M ) 

); 

} catch (Throwable t) { 
tprintStackTraceQ; 

} 

font = tmpFont; 

} 



Providing the font parameter to the factory means that the expected method 
names for accessing the attribute will be getFontO and setFontO- The exception is 
thrown if the attribute has already been registered with that domain. The primary 
integral ingredient of an AttributeDescriptor is the appropriate TypeMetaData. 

Figures 12A to 12D list an exemplary Java package called com.xis.types and 
its respective classes. In one embodiment of the invention, several packages 
containing various classes to implement the features of the present invention are 
contained in class libraries or APIs. 
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Referring again to Figures 2 and 4, the set of Relationships 210, 472, 473 that a 
given data item 440, 442 possesses with other data items is also exposed through 
standard method calls. One method retrieves the "member elements" belonging to a 
given element in a parent-child relationship. These members, are directly referred to 
5 by means of conventional object "pointers". 

Figure 13 is a block diagram representation of how relationships between data 
items within the XIS framework 100 are exposed in a generic fashion. Member-of 
(i.e., hierarchical) and reference relationships are supported 

Members enable the creation of a hierarchical data structure. A data source 

10 object may also have members themselves. When members are added or removed, it 
is the data source's responsibility to fire the appropriate events to inform any listeners 
that the data structure has changed. By nature, certain objects have members (like 
Collections or arrays). In one embodiment, the actual array is returned to the object 
requesting the relationship. 

15 A reference represents a pointer or a reference to an object. In one 

embodiment, an object may be referred to without instantiating that object until 
necessary. References in the XIS framework may also provide persistable or 
persistent data to define a link and may also refer to software classes/objects on how 
to later resolve such link to an actual live data item. These references may also 

20 provide annotations (e.g., description of links and their roles with respect to data 
items). 

Figure 14 shows how references may be resolved. Information regarding 
relationships, as stated above, may be obtained using object pointers, e.g., there is an 
object pointer from one data item to another data item to indicate a parent-child 
25 relationship. In this way, data source components may be able to determine which 
data items are directly or indirectly children of which others and the general 
relationships between data items. This set of relationship information may be used in 
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displaying and representing the data items with its own characteristic fashion. This 
relationship information, for example, may be helpful in an organization chart or an 
explorer-type consumer component Relationships, for example, may be a "peer-to- 
peer" or "members of 1 type. 

In Figure 13, for example, a data consumer Component A 1320 requests the 
relationship of a data source component 1313 (Source 1), via the mediation layer 1 12 
shown in Figure I. Via the same mediation layer 1 12, the data source component 
(Source 1)1313 returns a data item, which indicates the relationship of the data 
source component or data item, as shown in Source 11315. Similarly, the same data 
consumer Component A 1320 may request the relationship of data source component 
1330 (Source 2), and such relationship information is returned 1325. Another data 
consumer Component B 1340 may also obtain the relationship information of the data 
source (Source 2) 1330, i.e., the result 1335. As shown, the resulting relationship 
information 1325 and 1335, e.g., how the relationship is represented may depend on 
the data source component, for example, the relationship information shown in the 
box 1325 is different from the box 1335. 

In one embodiment of the invention, a unique ID for a data item is available in 
the current runtime environment. Such unique ID for a particular item need not be 
recreated (or a new unique ID created) except when the data has been completely 
unloaded and then reloaded, e.g., loading of a row from a database, unloading it, and 
then reloading (will usually result in a new unique ID). 

A second method retrieves links representing a more general and indirect form 
of relationship comprising a text annotation and a reference object which can be used 
to either obtain the referred data item (or information element) or retrieve or 
reconstruct it if it is not directly available. This retrieval or reconstruction need not 
take place until the moment the referred information or data element is actually 
needed. In particular, the reference refers directly to a "resolver" object on which- 
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when retrieval is actually requested— a method is called with arguments also specified 
in the reference. This method then returns the desired information element or data 
element. 

This mechanism is quite general; one possible implementation would be a 
5 resolver object able to make queries on a database and construct data source objects 
from the result. The reference could specify the particular query to be made, with the 
effect that a very small reference (comprised primarily of a query string, assuming the 
resolver class is loaded as part of the general mechanisms within the application) can 
be passed around between application components and only resolved into a large, 

10 memory intensive data object when some operation (such as display to a user) needs 
to be performed on it. Other types of reference retrieval mechanisms not involving 
databases are possible, such as query of network based services or collection of direct 
user input, i.e., anything that can be implemented within the implementation language 
can be used as a reconstruction procedure. 

15 Additional methods on a data element may be implemented to provide 

Relationship information in the reverse direction ,that is, to the elements that contain a 
given element and elements that refer to a given element may also be acquired 
through direct queries. 

Finally, a more dynamic form of information is accessible through a 

20 standardized mechanism by which interested data consumers 122 or sources 102 can 
register— through calling a particular method on the data source object 102-to receive 
events whenever one or more chosen aspects of a data source change. In particular, a 
data source maintains lists of those software objects interested in hearing about 
changes in attribute values, the addition or removal of attributes, the addition or 

25 removal of members or containers, and the addition and removal of references or 
referrers, and whenever one of these aspects changes, it sends a message to each 
object on the appropriate list. This mechanism, founded on the event passing 
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mechanisms found in many object oriented programming languages and libraries but 
centered around information structure as exposed generically within the XIS 
framework, enables different components of an application to "keep in sync" with 
information sources that change or grow during use. In other words, if a data source 
5 signals a change in an information element, all displays and computations can be 
updated immediately to reflect the change, much like a dynamically adjusting 
spreadsheet program. 

Figure 14 is an exemplary flow diagram that shows how a reference is resolved 
within an XIS framework. In the first block 1410, a data consumer component 

10 Consumer A produces or creates a reference to a data item Data X. In the next 
operation 1420, this reference is saved to disk, e.g., as a text file. In the next 
operation 1430, the data consumer component Consumer A is restarted and the 
reference is retrieved from the file saved in/the previous operation. In the next 
operation 1440, such reference is also passed to data consumers Consumer B and 

15 Consumer C. Next, at 1450, Consumer B requests resolution of the reference. This 
resolution is done in the next operation 1460, wherein Data X is constructed through 
executing a database query. This database query is stored as part of the reference 
information stored in the disk (block 1420). The query returns the data item Data X, 
which is then used by Consumer B (block 1470). Consumer C may also request 

20 resolution of the reference (block 1480). Considering that data item X has been 
resolved by the data consumer component Consumer B, Data X is not reconstructed 
again.from the database, rather a cached yersion is directly returned instead (block 
1490). This operation 1490 assumes that no change in Data X occurred. 
In one embodiment of the invention, the XIS framework models 

25 communication after the JavaBeans PropertyChange mechanism. Figures 36A to 36B 
show a listing of an exemplary package, com.xis.leif.event, which includes interfaces, 
event objects, and default implementation adapters for events in the XIS framework. 
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The UML sequence diagram shown in Figure 36C shows how a data source 
interacts with an INFOBEAN. In particular, it shows how a data source and an 
INFOBEAN interact when data is added. The INFOBEAN gets a LeifDataltem for 
that object and adds a listener. When the data source updates the object, or if any 
other INFOBEAN updates the LeifDataltem, the LeifDataltem fires events to all 
listeners. 

Each INFOBEAN may choose to listen for changes in the data it is using. If it 
would like to receive updates, it must attach a LeifDataltemListener to each data item 
to which it would like to listen. Thus, when something changes in the data, the 
listener receives the event. Upon receiving this event, the listener updates the 
corresponding data item if the change is one that concerns the INFOBEAN. 

Figure 36D shows a UML sequence illustrating how a data source and 
INFOBEAN interact particularly when data are updated. 

In one embodiment, state attributes are defined to assist in determining change 
events as well as management of references. The state attribute describes what state 
the data is in at any time. This may be implemented to determine whether a data item 
should be kept and whether to display it, for example, without listening to the parent 
of the data, if there is one. Exemplary states are defined below: 

(1) Deleted: When a raw data item is in this state, it is no longer 
being used and should be discarded. 

(2) Exists: When a raw data item is in this state, the data exists and 
is still being referenced as either a member of another raw data 
item or it is a DSI itself. 

(3) Live: This state includes everything in the Exists state. This 
state also means that the data item is also connected to a live data 
feed such as a database or server and that the connection is still 
alive. 
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(4) Dead: This state includes everything in the Exists state. This 

state also means that the data item was, at one point, connected to 
a live data feed, but the connection to the data feed no longer 
exists. An example of a Dead state is when the connection to a 
5 data server goes down and the data still exists in the DSI, but can 

no longer be updated. 
To better help understand the features of the invention, sample information- 
handling applications, using Java programming, are exemplified and discussed below. 
Example 1 

10 Figures 15 and 16 show two Java source files to implement an application 

within the XIS framework. The output is shown in Figure 17. 

Figure 15 lists the HelloWorldjava source file that creates a HelloWorld 
object, which is a data source component. This source file is a minimal Java object 
that satisfies the method conventions for a JavaBean, in this case, it contains "get" and 

15 "set" methods (which often but need not necessarily correspond to private member 
variables), and a toStringO method. 

Figures 16A and 16B list the TestHarness.java source file that creates a 
TestHarness object, which is a data consumer component. TestHarness contains all 
the code to access all the information exposed within XIS and display its 

20 properties/attributes using a PropertySheetlnfoBean. The PropertySheetlnfoBean is a 
data consumer component, which displays the attributes of a data source component. 

Referring back to Figure 16A, as shown in the portion of code 1602, many 
standard classes of the Java language are used. In addition, a set of classes provided 
within the XIS framework, particularly within the mediation layer, is also used, e.g., 

25 com.xis.leif.im.BaseInfoModel. The code for the class library for the com.xis.leif 
class is not shown herein. Various alternatives relating to what classes are needed 
would depend on how the XIS framework of the present invention is implemented, 
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designed, and the like, as will be known to those skilled in the art in view of this 
description. 

The first line in mainO of the HelloWorldjava code 1604 prevents the XIS 
PluglnManager from starting up. The PluglnManager is used for tying components of 
5 a large XIS application together based on resource files it finds associated with their 
classes. The PluglnManager is further discussed below. This feature is set to "off 1 to 
reduce the time to startup. ■ 

The lines of code shown 1606 in the first part of this source file sets up a 
predefined XIS InfoBean, in this case, PropertySheetlnfoBean that is capable of ■ 
10 displaying the available attributes of an object The attributes are obtained through 
the Java language reflection method, which are used to make a wrapper object in the 
addRawDataltemO call. This means that the addRawDataltem method in the 
"properties" class is predefined within the XIS framework. This addRawDataltem 
method will ultimately result in the invocation of the reflection feature of Java so that 
15 the various attributes contained in the data source HelloWorld object are exposed to 
be used by the PropertySheetlnfo. 

The PropertySheetlnfoBean uses the wrapper to access the attributes for 
display and, if necessary, enable the user to update the exposed attributes of the 
object. In this example, however, none of the attributes are editable. The 
20 PropertySheetlnfoBean also fires a close event when a "Cancel," "OKI," or close 
button is pressed. The next portion of code 1608 sets up a Java listener to exit the 
program when the appropriate button is pressed. 

The last portion of code 1610A and 1610B creates a JFrame (Java frame) to 
display the INFOBEAN (it extends java.awt.Component). A listener is added to exit 
25 the program when the window is closed. 

Figure 17 shows the resulting display application on INFOBEAN called 
PropertySheetlnfoBean. Example 1 is very simple, as it simply displays the attributes 



57 



WO 02/46916 



PCT/US01/48418 



exposed for the Hello World object in a tabular format Pressing a "close window" 
display button causes the application to exit 
Example 2 

Figures 18A, 18B, 19A, and 19B list two Java source files. These two Java 
5 source files function similarly to those listed in Figures 15 and 16. Modifications or 
additions to the code listed in Figures 15 and 16 are marked with 7* {*/" <new code 
here> 7*}*/} The resulting output is shown in Figure 20. 

Figures 1 8 A and 1 8B extend the previous HelloWorld class (Figure 1 5) by 
using the JavaBean standard property change event distribution classes so that other 
io XIS objects are automatically notified when its properties are changed (within the set 
methods). The java.beans i*ropertyChangeSupport instance takes care of maintaining 
lists of listeners and sending events to them. It is only necessary to implement 
wrapper methods to pass listeners to this contained instance (the first block of new 
code after the imports 1802) and then to call the firePropertyChange method 1804 on 
15 it when anything is actually changed. This is performed in the setValue 1808 and 
setMyColor 1810 methods. Value and My Color are editable fields. 

Figures 19A and 19B contain the TestHarness file. Similar to Figures 16A and 
16B, the TestHarness file contains code to expose an instance of this object within 
XIS. In this case, not only are the properties or attributes displayed using a 
20 PropertySheetlnfoBean, but a charting program, ChartlnfoBean, i.e., another data 
consumer component uses the same data item to display a chart accordingly. The 
ChartlnfoBean automatically searches for numeric attributes on the data item and 
plots them accordingly. The Numeric attributes are recognized as such through 
reflection when the raw data item, HelloWorld object, is wrapped within a 
25 LeifDataltem object. 

Similar to Figures 16A and 16B, the TestHarness file contains code to expose 
an instance of this object within XIS. In this case, not only are the properties or 
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attributes displayed using a PropertySheetlnfoBean, but a charting program, 
ChartlnfoBean, i.e., a data consumer component feeds the same data item to display a 
chart accordingly. The ChartlnfoBean automatically searches for numeric attributes 
on the data item, and allow them to be plotted. The Numeric attributes are recognized 
5 as such through reflection when the HelloWorld object was registered within the XIS 
framework. 

The first portion of code 1902 sets up a property sheet ENFOBEAN similar to 
Example 1. The second new code portion 1904, marked in the drawing by comment 
braces, sets up a second frame and puts a ChartlNFOBEAN into it Since the chart 
10 can display multiple data items, the method to feed it data items (addRawDataltems) 
1906 takes an array of objects. The method setChartType 1908 may be used to 
specify the type of chart, its axes, and so on. 

Figure 20 shows the PropertySheetlnfoBean displaying the attributes of the 
data item, i.e., the HelloWorld object. The charting component is not shown in the 
15 figure. 

Example 2 application puts up two windows-a property sheet displaying 
information on a HelloWorld object and a chart display (alternatively called a "plot" 
display) showing one or more of the numeric attributes of the same data item. On the 
property sheet, editable fields are surrounded by a darker gray background In 

20 particular, one may change the "My Color" property by clicking on it. Clicking on 
this property brings up a default editor for color attributes defined within this 
framework. In this embodiment, numbers, strings, dates, and several other kinds of 
attributes all have appropriate editors automatically set up for them within XIS, via 
the TypeMetaData facilities. 

25 The chart starts out displaying either the ED or the Value attribute. It may be 

changed by clicking on the Y axis label. This is also the way to set which kind of 
chart (bar, line, pie, etc.) is used. If the value being plotted (or the color) is changed 
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in the property sheet (and the display button "Apply" is pressed), the chart 
automatically updates. Similarly, right clicking on the part of the chart corresponding 
to a data item enables a user to bring up its property sheet In this embodiment, this 
kind of coordination is maintained automatically within the XIS framework through 
5 the use of the JavaBeans event mechanisms. It should be noted that when the 

application is run or executed, the color of the chart does not match the one set in the 
property sheet. This is because, although the PropertySheet recognizes that any field 
of type M java.awt Color" is displayable and editable as a color, the chart has no way of 
knowing which color field (if there are more than one) should be used. This may be 

10 solved, however, within the framework by using standardized Domain Attributes. 

In one embodiment of the invention, Translators are used within the XIS 
framework. As described earlier, a DSI exposes data information within the XIS 
framework for data consumers to use. Java reflection and introspection may be used 
to obtain attributes specified in simple objects and JavaBean, respectively. The XIS 

15 framework first searches for a Translator class for the data source object Translators 
are therefore optional considering that the attribute values and attribute descriptors 
may directly be obtained from an object Translators may also be used in order to 
keep the objects class simple so that it is capable of being used in non-XIS 
environments. 

20 In an embodiment, Translators are somewhat similar to the Beanlnfo class in 

JavaBeans. Like the Beanlnfo class, the name of the class must begin with the name 
of the data class followed by "Translator". For example, a DSI class named 
PlanObjectjava would have a corresponding Translator class 

PlanObjectTranslator.java. Also, similar to Beanlnfo classes, Translators must reside 
25 in the same class space in which the DSI is located. For special circumstance cases 
such as non-localized obj ects or custom Translator definitions, a Translator registry, 
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e.g., TranslatorRegistry, may be used to register a Translator for a given data item 
class. 

Table VIH below shows an exemplary code to register a Translator within the 
XIS framework. 



Table VIII 
// register the translator for File objects 
TranslatorRegistry.getTranslatorRegistryO 

t registerObjectSchema(PlanObjectxlass, 

PlanObjectTranslator.class); 



. The above code, as well as all code discussed herein, is provided to illustrate 
the functional behavior described herein. One of ordinary skill in the art will be able 

10 to produce the code, for example, to create classes, objects, APIs to affect this 
Translator registry. 

When the value of an attribute is requested from a data source component, 
using the mediation layer, the value from the attribute methods specified in the 
Translator, if any, is exposed. If the Translator does not exist, then the method in the 

15 object is invoked, i.e., the get+attribute method within the data source object. The 
Translator may directly invoke the object's methods as well. The Translator may also 
be used to wrap legacy code. For example, if the object class is a legacy code, which 
may not be modified, and has a color property, a Translator may be written to return 
the value of the color, for example, for the DisplayDomain.color attribute. In this 

20 way, the information may be accessed without modifying the original legacy code. 
The data in the data source object in effect has been normalized or tailored to the 
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domain policy specified The XIS framework in this embodiment provides the ability 
to integrate existing data item classes without modifying them. 

To integrate a data item class into the XIS framework, an accompanying 
Translator class should be provided. In this Translator class, the data source 
5 developer provides code that reaches back into the data item's class to expose its 
properties. It also serves as a way of normalizing access to these properties by 
imposing a common interface for all Translators to implement. 

Translators have two primary functions; 

(1) Translators provide an intermediate method from the caller of an attribute 

10 "get" or "set" method to the data source object, enabling a developer to translate the 
value from its internal representation to a representation understood within the 
framework, particularly, by the data consumer components. For example, an object 
may store a default color as a string color name, but the Translator may convert that 
color to a java.awtColor object 

15 (2) Translators also enable a developer to define attribute types more precisely 

(e.g., via AttributeDescriptor code, which provides detailed TypeMetaData and may 
map attributes to specific domains). This resolves any ambiguity in the attribute type. 
It should be noted that reflected properties that are converted into XIS attributes cany 
minimal semantics, which contributes to the usefulness of the XIS framework. For 

20 example, "float getDegreesO" by itself does not imply whether it provides an angular 
measure or a temperature measure, nor does it imply that the valid range is from 0 to 
360 or from 0.0 to 2.0 pi for angular measures, or distinguish between Fahrenheit, 
Celsius, or Kelvin for temperature measures. 

Translators also enable developers to convert objects that do not follow the 

25 JavaBeans get/set API design pattern. For instance, a data item could be implemented 
as a mapping of attribute names to values (e.g., String, Integer, Double, and Boolean). 
The Translator may map actual XIS attributes to these key/value combinations, 
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making XIS data items appear as if they were generated from the more typical 
JavaBeans-style objects. Example 3 shows how a Translator may be implemented in 
the XIS framework. 
Example 3 

5 Example 3 application is contained in three source files listed in Figures 21 , 

22A, 22B, 22C, 23A, 23B, 23C, and 23D. The resulting outputs are shown in Figures 
24Aand 24B. 

Example 3 functions similarly to Example 2 above, but enable finer control 
over the data item attributes exposed within XIS. In particular, the HelloWorld object 

10 is explicitly wrapped in a Translator rather than simply feeding it to XIS and letting it 
rely on reflection to display and manipulate the data. This allows some properties of 
the raw data item to be hidden, and allows other ones to be better "understood" within 
XIS. The HelloWoridTranslator java file contains the Translator. 

Referring to Figure 21 , the property change event-handling portion of code 

15 1506 found in Figure 18A has been removed from the set methods. These functions 
are now handled in the HelloWoridTranslator class (Figures 22A-22Q, which is 
registered with XIS by the TranslatorRegistry static call at the beginning of that class . 

Referring to Figures 22A to 22C, this file contains the HelloWoridTranslator 
class 2202 that wraps the HelloWorld object When an INFOBEAN encounters a raw 

20 data item, it ultimately accesses the raw data item through a Translator's methods, if a 
Translator exists. In one embodiment, all Translators are subclasses of the 
com.xis.leif.im.Translator class, which provides an infrastructure that facilitates the 
use of attributes already defined or set-up in an XIS Domain. Such attributes have 
type metadata predefined for them, and many XIS EMFOBEANs automatically access 

25 and utilize the metadata and the attributes themselves. 

The first member variable 2204 of the HelloWoridTranslator class lists the 
predefined XIS domains from which attributes are taken. In order to use an attribute 
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not in one of these domains, it may be necessary to provide a separate metadata for it. 
The second member variable 2203 defines an array, which lists auxiliary information 
on the fields, in tins case, whether they are displayed by default in the property sheet 
display. The getFieldMetaDataArray method 2206A and 2206B fills this array, if 
5 necessary, with the default metadata for the fields that are exposed by the get and set 
methods further listed below in the source file. The exception to the defaults is that 
the "course" attribute 2208 is not visible, i.e., it is not displayed under the "Preferred 
Attributes" on the property sheet It is displayed, however, when the "All Attributes" 
option is selected. Other things that may be set (but are not in the source file) include 
10 the sorting order and rank when multiple data items of this class are listed together, as 
in a table. 

The ensuing get and set methods 2210 define the attributes that the rest of the, 
XIS objects can see. In general, this refers to the enclosing raw data object, but this 
need not always be the case. For example, here, the HelloWorkTs integer Value 1 

15 property is map to the 'speed' attribute, which takes its metadata and its type (double) 
from the Movement domain 2212. The Movement domain has previously been 
defined. By handling conversions within the Translator, the rest of XIS "never 
knows" that there is really an integer value underneath. 

All change event propagation is handled through the request objects passed 

20 into the set methods 2214. Similar to Example 2, all XIS objects using the same data 
item are notified of the change. 

Referring to Figures 23 A through 23D, the TestHarness code is largely 
unchanged from Example 2, but at the end it includes a separate class that 
demonstrates how attributes may be altered on a data item that includes a Translator. 

25 In general, the procedure is to obtain, first, the LeifDataltem corresponding to the raw 
data item, then a "domain wrapper" that wraps this and enables access to attributes 
that come under that domain. Internally, the domain wrapper calls methods on the 
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Translator, but externally it presents an interface to the developer that depends only 
on the domain and not on the particular LeifDataltem being wrapped. 

The code in the Accelerate class is a standard thread implementation that uses 
the wrapper to successively change the Hello World data item's speed attribute. In 
5 other embodiments, this attribute may be altered by any portion of the program that 
has access to the data item. Because the wrapper eventually calls the Translator, Hie 
change events are propagated appropriately. 

The Example 3 application, similar to Example 2, displays two windows-a 
property sheet and a chart. Example 3 shows that the property sheet may be made to 
10 display more properties (in this case, the "course" attribute) by selecting "All 
Attributes" from the top menu, which ignores the "preferred" setting in the 
FieldMetaData. The attributes all have reasonable names, which come from the 
metadata stored in the domains. Finally, if the "Pen Color" attribute is edited, the plot 
changes color accordingly. This is because the Chart INFOBEAN recognizes and 
15 uses the "Pen* Color" attribute from the Display Domain if it finds one on the data 
item. Because of the various wrappers employed, it does not matter what kind of 
object is eventually underneath or what other attributes it has; as long as the "Pen 
Color" attribute is found, it will be used. 
Example 4 

20 Example 4 contains two source files namely Hello World and TestHarness. 

Figures 25A to 25C list the Hello Worldjava source file. This example shows 
translation without a Translator class. The resulting output is a property sheet 
INFOBEAN and a Chart INFOBEAN. Figure 26 shows the property sheet InfoBean, 
but the ChartlNFOBEAN is not shown. The HelloWorldTranslator.java file from 

25 Example 3 is eliminated Similar to above, the HelloWorld.java file has been marked 
such that changes from Example 3 are marked by open and close commented braces. 



• 65 



WO 02/46916 



PCT/US01/48418 



The Java source files enable some of the same fine control over the attributes 
exposed within XIS (see Example 3) without using a separate Translator class. If a 
developer has control over the Java code for the data source, the overhead of using a 
Translator may be eliminated by building some of its functions directly into the data 
5 source. It may, however, still be desirable to use a Translator because this avoids 
building any XlS-specific code into the JavaBean created and enables the code to be 
. more streamlined for use in non-XIS contexts. 

Figures 22 A to 22C contain the Hello World code, which include some of the 
code from Example 3, with some additional code for exposing attributes and 

10 providing field metadata as the Hello WorldTransIator class in Example 3. In fact, 
almost everything may be done from within this data item class that could be done 
with a Translator except for two things. First, attributes cannot be hidden from XIS-- 
everything with a get() method is exposed. Second, Translators may be used in 
conjunction with security features, for example, embodied in the XIS framework to 

15 restrict access to visible properties in a generalized fashion across all data items. 

The first portion of code 2502 provides methods for XIS to obtain information 
on which data item properties have attribute information provided for them. The XIS 
components first introspect on the data item to find its properties, then try to call the 
get(property name)Descriptor for each property. For those instances where this fails, 

20 the XIS component may provide its own attribute descriptors where it recognizes the 
type of the attribute. For example, the property sheet recognizes Color, Numeric 
(various subtypes), Date, and String attributes. The next portion of code 2504 
initializes a PropertyChangeSupport instance, because property change events must be 
handled here, similar to Example 2. 

25 Following this are several methods unchanged from Example 3, but the set() 

methods have been altered to resemble those from Example 2 in which property 
change events are fired. Next, there are several new get() and setQ methods which 
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expose the properties with the same names as the Translator did in Example 3. These 
names correspond with the getAttributeDescriptor methods listed above in the code, 
and the XIS components interpret them accordingly. These properties show up as 
preferred attributes in the property sheet, whereas those properties without 
corresponding attribute descriptors become nonpreferred attributes. 

The portion of new code 2506 following this provides field metadata for this 
raw data item- This program code is almost identical with those in the Example 3 
HelloWorldTransIator, except that both the variable and the method are now static, 
and the "Course" attribute removed to reduce clutter. 

The TestHarness file for Example 4 is generally unchanged from Example 3, 
except the code to register a Translator is removed The portion of program code 
2302 in Figure 23 A is removed in this example. 

This Example 4 application is largely similar to Example 3, except that if the 
"All Attributes" option is chosen under the property sheet, then the previously 
unexposed "value", "myColor", and other attributes appear. The chart is also able to 
display the "value" and "ID" properties. 

Figure 26 shows a window display of the property sheet output from the 
Example 4 application. 

Processing Flow for Exposing Data 

Figure 27 A and Figure 27B show a flow diagram of how information about a 
data item, e.g., a data item as shown in Figure 5, is exposed to data consumer 
components. In the preferred embodiment, data exposure within the system may be 
accomplished by one of three methods, described further below. There are two 
primary functions to be performed: (1) interfacing with an internal or external data 
source such as a set of disk files, a database, or a web service; and (2) exposing the 
resulting data according to the standard interface outlined above, e.g., following the 
domain interface, relationships interface, and the like. 
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In the first method of exposure, one software component performs both 
functions; in the second method, separate software objects perform the two functions; 
in the third method, which is only implementable in an object oriented programming 
language that provides self-analysis facilities, such as Objective C or Java, the 
5 exposure function is performed automatically by the system. More particularly, in the 
first method, a data source interface (DSI) software object is written that connects to 
an external data source such as a local file system, an Internet site, or an RDBMS. 
The DSI object converts the information provided by the external data source into the 
information representation or data item that may be consumed by data consumer 

10 objects as described above. In a preferred embodiment of the invention, the data 
source DSI objects are from the LeifDataltem class. 

In the second method, the API of an existing software data object is accessed 
. by a Translator object, which then exposes the information to other data consumers in 
the representation format discussed above. This arrangement is referred to in the 

15 object oriented design literature as an Adapter or Wrapper pattern. See, for example, 
Gamma, E_, Helm, R., Johnson, R., Vlissides, J. (1995); Design Patterns: Elements of 
Reusable Object Oriented Software; New York: Addison-Wesley. This is generally 
referred to as "wrapping". More precisely, a data consumer component requests 
information from the Translator object, which then converts the request into 

20 something the original data source object can deal with. The consumer then converts 
that object's response into the appropriate format for a response to the original call. 

The third method applies the facilities within a self-analysis-capable 
programming language such as Java or Objective C. This type of programming 
language enables an object to determine the available data fields and function calls 

25 afforded by another object while an application is running. In the preferred 

embodiment implemented in Java, die queried object must be a "JavaBean" according 
to Sun Microsystem's suggested convention, with "getQ" and "set() n method calls. 
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Each data field available through one of these calls, or by virtue of being a "public" 
variable, is examined, and the resulting type information is used to expose both the 
field's value and appropriate metadata to data consumers. If the field is a numeric 
type (double, Double, float, Float, Integer, int, long, or byte in Java), it is exposed as a 
5 decimal or integer with an "unknown" unit of measure. If the field is a string (String 
in Java), it is exposed as a text element If the field is a complex object, it is exposed 
as a linked element via a reference (discussed above), unless a special class has 
registered to handle the complex object type within the application context or XIS 
framework. 

10 In another embodiment, in addition to the facilities for exposing data, the XIS 

framework provides an apparatus for allowing application context to affect how 
information is exposed. This is illustrated in Figures 27 A, 27B, and 28, described 
further below. The attributes, methods, and relationships available for a given data 
source are determined by a surrounding structure called an InfoModel. The 

\ 5 InfoModel connects the pieces of the XIS framework together. It is an interface 

comprising an object that knows how to return data item information. See also Figure 
3A discussed above. 

In another preferred embodiment, an application comprises one or more Views, 
each containing and providing an InfoModel to one or more data consumers, termed 

20 INFOBEANS as described above, which may provide display, computational, or 
interactive facilities. All of the Views are in turn managed under a single ViewHost, 
which provides the global application context Conceptually, a view represents a 
single perspective of the current data. One single perspective (or view) could be quite 
different from another because of the ability to add/override attributes in a view. 

25 View creates a new InfoModel that in turn creates new LeifDataltems that are used 
within that view. This is done to separate context sensitive attributes between an 
InfoModel and another View, INFOBEAN, or InfoModel. Views are also used as a 
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controller of one or more INFOBEANs by managing the data flow to each individual 
INFOBEAN. All Views are also by definition INFOBEANs since they manage 
information flow with generic means. The ViewHost is used to manage the complete 
set of Views and INFOBEANs, thus presenting each view to the user in a uniform 
5 fashion such as frames, windows or other display mechanisms. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. The 
diagrammed operations will occur when the XIS framework is loaded into program 
memory of a computer system that supports an object oriented programming (OOP) 

10 environment, as will be understood by those skilled in the art. In the first processing 
step, at block 2702, a data source object is registered within the XIS framework of the 
computer system. When a data item is brought into the framework, it is exposed to 
data consumer objects, e.g., via an InfoModel, typically via one of three methods. The 
first operation is to determine whether a Translator object is available and whether the 

15 Translator object is registered for the raw data object type. This processing is 
represented by the decision block 2704. 

If the Translator is available, an affirmative outcome at the block 2704, then at 
block 2760 the data item attributes, methods, and Domains are obtained via the 
Translator. If the Translator is not available, a negative outcome at 2704, then at 

20 block 2706 the data item object is scanned to find the data object's methods. The 
scanning may be accomplished with facilities of the OOP environment of the host 
computer system, such as InfoBeans. 

After the data item object has been scanned at block 2706, the system next 
checks to see if the data item includes an XlS-standard data exposure interface (that 

25 is, a predefined interface known to the XIS framework). If the standard interface is 
available, an affirmative outcome at block 2714, then at block 2762 the data item 
object attributes, methods, and Domains are obtained from the data source object 
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itself. The system then checks for references to Domain Policies at block 27 if 
there is no standard interface available at the decision block 2714, then processing 
moves to the block 2764, where the facilities of the programming language of the 
OOP environment are used to interrogate the data item object to determine the object's 
5 accessible data fields. Processing then moves to exposure attribute processing via the 
off-page connector B to Figure 27B, described below. 

Returning to block 2762, after the data item attributes, methods, and Domains 
are obtained, a check is made for Domain Policy references at the decision block 
2763. If there are references to Domain Policies, an affirmative outcome at the 

10 decision block, then at block 2765 a check is made to determine if there is 

FieldMetaData override for a Domain. If there are no Domain overrides, then at 
block 2710 the definitions from the referenced Domain Policy are used for the 
attribute metadata. The processing then moves to exposure attribute processing via 
the off-page connector A. If there are Domain overrides, an affirmative outcome at 

15 block 2765, then at block 2716 the system uses the definitions included with the data 
item object Translator for the attribute metadata of the data item. The processing then 
moves to exposure attribute processing via the off-page connector A. Referring back 
to block 2763, if there were no references to Domain Policies, then processing 
proceeds straight to block 2716 to obtain the attribute metadata definitions and then to 

20 the exposure attribute processing via the off-page connector A to Figure 27B. 

Turning to the processing of Figure 27B via the off-page connector A, the data 
item attributes are exposed to the local InfoModel class (i.e., a DSI object). Next, at 
the decision block 2770, a check is made to detennine if the data item has any 
dynamic attributes. If the data item does, then at block 2772 the framework 

25 processing adds the dynamic attributes to the available data item attributes. If the data 
item has no dynamic attributes, or after any dynamic attributes have been added, 
processing moves to block 2773, where the system checks to detennine if a Translator 
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was provided (registered) for the Data Source object If a Translator was provided, 
then at the decision box 2775 the system checks to determine if reflection has been 
requested. Those skilled in the art will understand that reflection is an operation that 
is provided by most OOP environments, such as by Java. 

If reflection is to be performed, then processing returns to Figure 27A via the 
off-page connector C, whereupon the Data Source is scanned. If reflection is not to 
be performed, or if no Translator was registered (a negative outcome at block 2773), 
then processing moves to the decision block 2774. At block 2774, the system checks 
to determine if the data item has registered any extended Translators. If there are no 
extended Translators, then at block 2718 the data item attributes are derived, added, or 
hidden, depending on the data context gleaned from the DSL The data item is then 
fully exposed to data consumer components for use (block 2790). If there are 
extended Translators, an affirmative outcome at block 2774, then processing Teturns 
to Figure 27A via the off-page connector B to obtain the information from such 
Translators (block 2760). 

Figure 28 is a diagram showing how InfoModels provide contextualization 
within the XIS framework. The initial "raw" object (e.g., Java object or data from 
RDBMS) provided by the data source is exposed through mediation by successive 
"wrapping layers" of other objects, which determine which fields are visible, and 
possibly performs conversions or consolidations. Each "View" within the XIS 
framework, which contains one or more "INFOBEAN" consumers, carries with it its 
own context. Feeding a data source component to a consumer component places it 
within that context. 

When a data element provided by a data source is introduced to an InfoModel, 
the InfoModel actually provides a new element derived from this one to consumers. 
This derived element provides the actual data source interface discussed above. The 
attributes, type metadata, and methods provided for the element are first determined 
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as described below under "data exposure facilities"- Then the InfoModel inspects the 
results and decides whether to add or derive any new attributes, or to hide existing 
attributes. Once the data is added to an InfoModel (discussed below), it may be asked 
for by other components for processing and visualization purposes. 

In another embodiment, the ViewHost, a data consumer component, provides 
facilities allowing interactive cut and paste and drag and drop of information elements 
between different consumer components. When a cut-and-paste or drag-sand-drop 
occurs, each information element is decontextualized and then recontextualized inside 
the new InfoModel into which it is placed. This means that some attributes 
previously available may be removed, whereas others, more appropriate to the 
functions of the recipient consumers), may be added. 

Referring back to Figure 28, this figure shows how multiple InfoModels work 
to share references to raw objects. This figure also illustrates bow an INFOBEAN 
and/or a DSI adds objects to the InfoModel to obtain data items. The DSI 2815 
creates an instance of source raw data item (e.g., Java object) 2830. The original 
source objects are maintained by DSI and one or more InfoModels have references to 
these source objects. The raw data item 2830 is provided to or may be used by an 
INFOBEAN (data consumer) via the addRawDataItem0 method. (Please refer to 
Table III above. The second line of code shows that the source object is added to the 
TablelnfoClass.) 

The INFOBEAN 2820 requests the data item for the raw object 2835 (which 
was the source object 2830) from its InfoModel or the BaselnfoModel. The 
BaselnfoModel as discussed above is responsible for creating and caching every data 
item (wrapping any object). Each InfoModel is considered to contain a subset of data 
items from the entire set of data. The InfoModel is a view of the BaselnfoModel, 
thus, there may be data items in the BaselnfoModel that are not present in the 
InfoModel used by the INFOBEAN. The circles 2828 shown in the InfoModel 2805 
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represent attributes, domains, relationships, etc. from the BaselnfoModel. For 
example, Figure 6 contains a list of information that an INFOBEAN may obtain about 
the Person object, in this case 2830, 2835, through the LeifDataltem API. In addition 
information from nested InfoModels are inherited. An InfoModel 2805 also always 
5 adds new items to the BaselnfoModel, e.g., common attributes such as "selection" are 
delegated These new items are also exposed to the INFOBEAN as shown by the 
number of circles in 2840. 

The BaselnfoModel 28 10 returns the raw data object 2845 to the InfoModel. 
The InfoModel 2805 returns a data item 2840, which exposes the information, for 
10 . example, shown in Figures 4 and 5 to the INFOBEAN 2820. A data item 2845 (see 
Figure 4) is returned, which may have been created or may have already existed in the 
InfoModel. 

In the XIS framework, as shown in the InfoModel, attribute and method 
"requests" mechanisms are available. Standard mechanism to retrieve the current 
15 value of any Attribute, or set the current value, if the Attribute is mutable, may also be 
. easily implemented. In one embodiment, this mechanism also enables a standard 
syntax and mechanism for the invocation of any domain method. 

These attribute and method "request" objects contain all of the information 
necessary for the data source to fulfill the requested task. It contains the actual 
20 ("raw") data item whose attribute value is being sought or set (along with the desired 
new value), or whose domain method is being invoked. They also contain contextual 
• information, such as the current User, allowing data source developers to implement 
full user-based information access and security controls, and a context for obtaining 
services (implemented through the Java "BeanContext" APIs). This is significant 
25 because it enables the process of executing methods and/or getting or setting values to 
leverage services "in context 11 such as the current data view (or window) through 
which to interact with the user. These request objects also contain contextual "data 
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item" (e.g., LeifDataltem), as opposed to the "raw" non-contextual data item, from 
which to get additional or overridden values or execute additional/overridden 
methods, if appropriate to the task. In another embodiment, these "Request" objects 
are not only passed when getting/setting values, or executing domain methods, but are 
s also passed to all other 'Translator" methods that take and may need to access or 
manipulate the data item. The "Request" object not only provides context, but also 
ensures that the DSI (via the Translator) always has what it needs (particularly, the 
User information) to manage its security constraints, if any. 

A data item locking mechanism for obtaining, holding, and releasing a lock on 

10 an individual data item may be implemented in accordance with the present invention. 
This implementation is best defined by the data source provider, by implementing 
such locking mechanism in the data source, itself. Ad hoc implementations for data 
sources that do not provide native locking may also be done via the DSIs. This 
mechanism enables DSIs to implement multiple changes atomically (as one 

15 transaction) by effecting those changes at the time of the release. In addition, a 
"rollback" feature for atomic changes is possible through the "revert" capability, 
which generally releases the lock without affecting the previous changes. This 
locking mechanism may also be leveraged to lock multiple objects simultaneously, at 
the discretion of the DSI, by associating the lock with a DSI-defined 'lock object" 

20 which can either be associated with a single data item or with a group of data items, as 
appropriate. Using the DSI API, this provides to data consumers a single API for 
dealing with locking implementations. 

Figure 29 shows an embodiment of a "plug-in manager" called PluglnManager 
of the present invention. The programming framework embodied in this invention 

25 includes a ,L plug-in manager" which provides extensible communication between 
services and components within an application. Plug-ins are software modules that 
add a specific feature or service to a larger system (i.e., plug into a larger application 
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to provide functionality). For example, there are a number of plug-ins for the 
NETSCAPE NAVIGATOR browser that enables the browser to display different 
types of audio or video messages, e.g., SHOCKWAVE by MACROMEDIA. 

A "service" is capable of obtaining information on a data consumer or data 
5 source component and capable of using that information to provide specific facilities 
. to the application as a whole. Examples of such facilities include addition of entries 
to a top level application menu, loading MIME types into the global MIME type map, 
and running of scripts upon loading or unloading of data sources or consumers. The 
plug in manager loads new services at initialization and also at any time through an 
10 explicit request. The service in turn queries all modules present in the application as 
to whether they request any actions of the given service, executing them if so 
indicated. 

In more detail, as each new module, object, or component is loaded into the 
XIS framework, the PluglnManager 2905 on startup loads a special service called 

15 PluggableServiceFinder 2925, which searches for other services 2915 and loads the 
services found into the PluglnManager 2920. The PluglnManager holds or keeps 
track of all services. These services are referred to as PluggableServices. As each 
pluggable service is loaded, the PluglnManager searches such service for defined 
resources and attaches these resources to the appropriate components or performs 

20 actions on resources found 2935. For example, a menu manager service might search 
for resources specifying menu entries and associated operations. A component that 
wants to add a menu entry to the global application menu bar would simply provide a 
resource of this type. In essence, as each new module is loaded, the PluglnManager 
tells the currently registered services ("PluggableServices") to look for new plug-ins. 

25 Thus, in essence the PluglnManager acts as a plug-in for plug-in handlers. 

The combination of the PluglnManager and the PluggableService interface 
allows communication between an XIS application and various XIS components. The 
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components may contain a number of resources that affect certain areas of XIS. For 
example, they may have a resource file that contains an ECMA script, ECMA is an 
international industry association dedicated to the standardization of information and 
communication systems (see www.ecma.ch). If there is a PluggableService that 
5 knows about that resource file, then it may decide to run the ECMA script when it 
finds the resource. The PluglnManager is responsible for managing the resource list 
and all PluggableServices. When a new PluggableService is added, it is given all the 
resources to determine if it is interested in any of the resources on the list. If it is 
interested in a resource, then it may perform some action. 
10 In one embodiment of the invention, an ASCII file is created to indicate that a 

JAR file contains a resource to be provided to all PluggableServices. 

Table IX below shows an exemplary ASCII file that indicates that there are 
resources associated with the module containing the Table View class. It does not 
indicate what resources exist; it is up to the PluggableServices to determine if there is 
.15 a resource in which they are interested. The PluglnManager, using Class.forNameO, 
creates the Table Viewxlass and calls the loadPlugln method on each of the 
PluggableServices. Below is the content of the loadPlugln method in the 
MimeTypesPluggableService: 



Table DC 

public static final String RES OURCE_NAME = "leifResources/mime.types"; 
public void loadPhigIn(Class relativeClass) { 
if (loadedResources = null) { 
synchronized (this) { 
if (loadedResources = null) { 

loadedResources = new HashSetQ; 
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} 

} 

} 

try{ 

String resource = PlugInManager.convertResoiirceNaTue( 

relativeClass, KESOXJRCE_NAME); 
ClassLoader loader = relativeClass.getClassLoaderO; 
Enumeration enum = loader.getResources(resource); 
while (enum.hasMoreElementsO) { 

URL resourceURL = (URL)enum.nextElementO; 

if (resourceURL != null) { 

if (!loadedResourcesxontains(resourceURL)) { 
loadedReso\irces.add(resourceURL); 

LeifJAFUtilities.addMimeTypes( 

baselnfoModelgetOwnedBeanContextChildO, resourceURL); 
} 

} 

} 

} catch (lOException e) { 
e.printStackTiaceO; 

} 



The entire arrangement of data sources separated from consumers by a 
mediating structure, InfoModels providing context to Views, and a ViewHost and 
5 plug in manager playing set central organizing roles, allows a multi-purpose 
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application to be rapidly assembled out of preexisting components. Each available 
data source and consumer component may be integrated into the application by the 
plug in manager, and compartmentalization. 

Figure 30 shows a flow diagram of an embodiment of the invention that assists 
5 in creating XML (extensible markup language) DSIs and database DSIs. The XIS 
framework provides two sets of facilities for exposing electronically available 
7 information that comes from data sources that are partly structured and/or self- 
describing, and for writing back possibly modified information to the sources. For 
example, one of these works for XML formatted data, and the other works for data 

io stored in relational databases. However, the mechanisms are inherently extensible to 
any other data source that is partly structured and/or self-describing. 

The World Wide Web Consortium (W3C), which has standardized most of the 
XML formats to date, is in the process of defining a new XML format for declaring 
schemas, called XML Schema. The XML schema addresses the means for defining 

1 5 the structure, content, and semantics of XML documents. The present invention is 
configured to take into account future versions of the XML schema. 

In one embodiment, the present invention includes aspects of the method 
outlined below that are in common between the XML and relational database 
interfaces and can be applied in this general capacity to be part of the invention as 

20 well. In particular (described further below), an embodiment includes the apparatus 
involving separate processing of "data" (3002 branch) and "schema" (3004 branch) 
information, with a type conversion stage 3012 during the former and a metadata 
creation stage 3014 during the latter, followed by the construction of semantically 
enriched attributes 3016, 3018 based on the results of both these processes. 

25 In one embodiment, one method involves two apparatus or facilities designed 

to handle extensible markup language (XML) formatted data. An XML text stream 
comprises of a set of hierarchically structured "tags" interspersed with text "content". 
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The names, data types, and ordering of the tags may vary from stream to stream and is 
specified by a separate document called an "XML schema." A description of the 
XML schema is provided in the document "XML Schema Part 1: Structures (Working 
Draft)", which may be obtained from the W3C at the WWW address of 
5 http://www. w3.org/TR/xmlschema-l, and also in the document "XML Schema Part 2: 
Datatypes (Working Draft)", which may be obtained at the WWW address of 
http://www.w3.org/TR/xinlschema-2. Given an XML data stream, the first apparatus 
parses the XML schema appropriate for it and constructs metadata specifications 
appropriate for the contents of each tag. In some cases, these specifications are in the 

10 form of computer program segments that can be compiled into executable procedures 
that can be accessed immediately by a running application; in other cases, they refer 
directly to already precompiled procedures. The second apparatus parses the data 
document, matching the tags up with the types and metadata derived from the schema, 
and exposes the content in the standardized information representation using this 

15 metadata. This information includes the generic relational links described above in 
addition to attributes and metadata. 

In particular, the structures defined by an XML schema document determine 
the hierarchical and type structure allowed in XML instance documents, and this 
structure is paralleled again in the information elements (with attributes and member 

20 elements) constructed on parsing an instance. The following table (Table X) shows 
the correspondence: 
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Table X 


XML Schema 


Compliant XML 
Instance 


Resulting Information 
Element 


simple type outside attribute 
declaration 


element with no 
subelements 


(typed) attribute 


simple type inside attribute 
declaration 


attribute 


(typed) attribute 


complex type without 
descendents 


element with attributes 
but no subelements 


information element with 
attributes 


complex type with 
descendents 


element with 
subelements 


information element with 
member elements 



A complexType element, as defined in the W3C XML Schema standard, 
defines the structure of an information element. Elements contained within the 
complexType element which are defined as complexTypes themselves, are translated 
into the member elements of the information element defined by the containing 
complexType. All other elements and attributes contained within the complexType 
element, and defining single value types, are translated into attributes of the 
information element defined by the containing complexType. 

The XML ingestion process supports an additional capability that allows for 
the translation of types defined by an XML Schema, into more semantically rich 
domain policy based attributes that consumers in the present framework can take 
advantage of. To do this an embodiment of the present invention includes a process 
that uses XSLT (XML Stylesheet Language Transformations) to scan an XSDL 
(XML Schema Definition Language) document, and embed domain specific 
instructions in a new version of the XSDL document The embedded instructions 
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direct the XML processing software to create information elements that contain the 
semantically ricjaer domain attribute representations. In particular, the tags in the 
table below may be placed by the XSLT within <appinfo> subelements of elements in 
the XSDL schema document When the schema parsing apparatus reads the resulting 
5 schema, it sets up the XML processor to perform the mappings as shown when 
reading an instance document. Because of the nature of the handling specified for 
<appinfo> elements in the XSDL specification (see the W3C Web site at 
http://www.w3.OTg/XML/Schema), these will simply be ignored by other XML 
schema processors that have not been designed to read them. Table XI lists properties 
10 that may be used: 



Table XI 


Property 


Description 


domainfield 


A Domain Policy attribute to map instances of this XML element 
or attribute to 


typemetadata 


A metadata type to map instances of this XML element or 
attribute 


converter 


A type converter for transformation of XML data values (strings) 
into typed values such as floating point numbers ot date objects 


visible 


The initial visibility state with which instances of this XML 
element or attribute should be exposed within an information 
element 


mutable 


Whether or not instances of this XML element or attribute can be 
edited after being exposed within an information element 
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Conversely, the system has the ability to construct an XML document and 
associated XML Schema from a hierarchy of information elements. The process for 
outputting an XML document and associated XML Schema from a hierarchy of 
information elements is essentially the reverse of the ingestion process. The resulting 
5 schema documents are generated with the special <appmfo> instructions that carry the 
additional semantic meaning for the attributes, but (see above) these additional 
instructions are embedded in a way that makes them transparent to other XML 
document readers that do not recognize them. In this way, an application-to- 
application information communication session can be set up using HTTP or a similar 

10 protocol for synchronous communications, and SMTP or similar for asynchronous 
communications. The sending application encodes information elements into an 
XML schema/instance pair using the just described apparatus and sends both to the 
receiver application. The receiver reconstructs the information elements also using 
the above apparatus. Thus, any form of structured, annotated information that can be 

1 5 expressed within our framework can be transmitted between applications using a 
simple document transfer protocol Another embodiment of the present invention 
involves an apparatus 3020 , which will connect to a relational database system and 
extract or write information from it using the structured query language (SQL). The 
user of such an information source needs only to specify the tables and columns to 

20 access within the database, as well as any selection criteria to narrow the range of data 
returned. The apparatus performing this rfunction will automatically convert the data 
in the database into the appropriate representational format and add metadata and 
parent-child links as required. In general, the process is similar to that described for 
the XML data input/output capability, except that SQL statements and conversion 

25 mappings specified by the user take the place of the XML schema and document type 
and hierarchy information. 
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The process translates the result of a database query into an XIS data item, and 
each row in the result set is translated into a member data item of the result data item. 
Each row data item can also have a database query associated with it which can be 
executed to provide its own member data item. Access to the member items is on- 
5 demand (e.g., as called for by a consumer), an operation we refer to as "drill-down". 
The row data items are created with attributes that are derived from the 
columns returned by the result set. The attribute specifications can be generated 
automatically from the result set column SQL type specifications (integer, date, text, 
etc.), or can be customized to suit the needs of the user. The customization process 

10 allows the user to map database result column type definitions into more semantically 
rich domain policy and/or metadata-enhanced attributes that consumers can take 
advantage of. In other words, the DSI can associate column data types with metadata 
types and domain policy attribute types. To do this the framework supports a number 
of attribute customization properties that the user can specify (described further 

15 below). 

Modifications to row data items are handled by allowing the user to associate 
parameterized update, insert and delete queries with a given result set When the 
value of a record member attribute is changed, the user specified parameterized query 
is executed, and the parameters are filled in from the attribute values identified in the 
20 query specification. Insertion and deletion of record members are handled in a 
likewise manner. 

The following table, Table XII, describes the list of customizable properties 
supported by the SQL database interface process. These properties are used to 
describe a single interface to a database for producing one or more hierarchically 
25 organized information elements from its contents. 
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Table XII 


Property 


Description 


jdbc. driver 


JDBC vendor driver class name 


jdbc.url 


JDjBC database connection URL 


display .name 


Default display name for result data item 


<ielprt nuerv 


SOT Sfilftfit Qfrat^mfint *fhr result ftat$* item 


update.query 


Parameterized SQL update statement 




jtvcouiL uuiuxuii iiaiiico uicti xiii upuaic query paramct&rb 


incprf nilPTV 

UU>Ci L+ 4 UOl Jr 




insert, columns 


Result column names that fill insert auerv narameters 


delete.queiy 


Parameterized SQL delete statement 


delete.columns 


Result column names that fill delete query parameters 


drilldown. query 


Parameterized SQL select statement for record drill- 
down 


dxilldown.columns 


Result column names that fill drill-down query 
parameters 


resuttattributes 


Result data item attribute names 


recordattributes 


Record data item attribute names 



The names of attributes listed for both result and record data items are used to 
uniquely identify the attributes. The customization of each attribute is done according 
5 to its unique name. The following table (Table XDS) describes the list of 

customizable properties that can be applied to each attribute, where <name> is the 
unique attribute name. Note the parallel between these properties and those given for 
the f <appinfo> ! tag insertion in the case above of XML data parsing. 
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Table Xffl 


Pronertv 


Description 


<name>.label 


The attribute display label 


<name>.domainfield 


A XIS Domain Policy class field to map this attribute 
to 


<name>.typemetadata 


A XIS metadata class name to map this attribute to 


<name>.converter 


A XIS type converter for transformation of result 
values 


<name>xolumns 


The result columns names that will be converted 


<name> .visible 


The attribute initial visibility state 


<name>.mutable 


The editability of the attribute 



Given the metadata from known industry standard APIs (e.g., JDBC and 
ODBC) that provide metadata for results (typically handled as tabular columns) 
5 including string, length, numeric precision, date formatting, etc, relational databases 
may have dynamic DSI toolkit built and implemented as shown in Figure 27. Tabular 
data may also be interpreted as a default string typed Java objects, remote Java 
objects (via RMI or CORBA-derived interfaces), and Enterprise JavaBeans (a variant 
of RMI objects) may have DSIs automatically created for them, using, for example, 
10 reflection and known types (primitives and other typical types like String, Data, etc., 
and registered types). A developer may also place XlS-specific annotations (e.g., 
static AttributeDescriptor and FieldData methods) on reflected Java objects. 
Collection subclassed objects may also indicate containment. 

Dynamic data supplemental metadata may also be used in the XIS framework 
15 of the present invention. Schemas with little or no expressive information may also 
be used to specify additional metadata within the XIS framework, which include 
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mapping attributes to type metadata, mapping attributes or methods to domains, 
defining new attributes/methods based on existing data from the source, defining 
functions/user commands for easily implemented capabilities (e.g., deleting a data 
item, adding/inserting a new data item, initializing a template data item that a user can 
5 fill in before adding, etc.), and defining relationships to other data items to perform 
"drill-down" queries. Such type of schemas may be obtained, for example for Java 
Metadata API> CORBA API (on which the Java API was based), Oracle "common 
warehouse metamodel," and the like. Other formats for mapping metadata to schemas 
from other sources, or as might be defined in the future, may easily be incorporated 
10 within the framework. 

Distributed Application Capabilities 

In an embodiment, the application development framework being discussed 
offers three sets of facilities to aid in the development of distributed applications in 
which users, software application components, or both are distributed across multiple 
1 5 computers connected by a network. 

CORBA Exposure 

The first set of facilities allows the automatic exposure of a data source over a 
network to any remote consumer software object via the Common Object Request 
Broker Architecture (CORBA) protocol. This protocol allows the remote consumer to 
20 utilize information elements just as if they existed locally, but usually with lower 

bandwidth than it would take to send the entire elements over the network connection. 

To better -understand the invention, examples are shown below in Table XIV, 
which shows an exemplary XML document. 



Table XIV • 


<tracks> 




<track name='TTRST"> 
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~ <country>US<^couiitry> 
<categoiy>SUB</category> 
<threat>HOS</threat> 
<position> 

<lat>10.0</lai> 
<on>10.0</lon> 
<alt>10.(X/alt> 
</position> 
</track> 

<track name^'SECOND'^ 
<country>US</country> 
<categoiy>AIR<ycategory> 
<threat>FRI</threat> 
<position> 

<]at>20.CK/Ia£> 
<lon>20.(K/lon> 
<alt>20.0</alt> 
</position> 
<track> 
</tracks> 



The following table (Table XV) shows the result if thp above XML document 
were run through an XML DSL 

5 

Table XV 

LEIF Data Item - tracks 
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LED 7 Data Item - track -— — 

Attribute - name : String vahie=TIR3T 
Attribute - country : String value= ? US' 
Attribute - category : String value^'SUB' 
Attribute - threat : String value='HOS' 
LEIF Data Item - position : LEIF Data Item 
Attribute ~ lat : String valued 1 0.0* 
Attribute - 3on : String valued 10.0' 
Attribute - alt : String valued 10.0' 
LEEF Data Item - track 

Attribute - name : String value^'SECOND' 
Attribute - country : String value^'US* 
Attribute - category : String value^'AIR/ 
Attribute - threat : String value='FRP 
LEIF Data Item - position 

Attribute - lat : String value= , 20.0' 
Attribute - Ion : String value='20.0' 
Attribute - alt : String value^'20.0' 



Table XVI below shows an exemplary XSDL document. 



Table XVI 
<?xml version="1.0" encoding^UTF-S 7 *?? 
<schema xmlns="http://www.w3 .org/1 999/XMLSchema"> 
<element name-'tracks 1 ^ 
<complexType> 

<element name="track" type-Track" maxOccuxs= ,f unbounded r V> 
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</complexType> 
</element> 

<complexType name-Track 1 ^ 

<attribute name= M name ,r type- 'string"/^ 
<element name-'country" type="string7> 
<element name="categoiy" typeF="string M /> 
<element name= rf threat rt type= rr string"/> 
<element name- 'position" type- 'LatLonAlt"/> 

</complexType> 

<complexType name="LalLonAlt n > 
<elementname= ,, Iat M type=Mecimal f 7> 
<element name="lon" type= r, decimal"/> 
<elementname=="alt" type= "decimal "/> 

</complexType> 
</schema> 



XML Schema Definition Language (.xsd) documents are used to express the 
semantic descriptions of Attributes and the Domains in which they live. Code 
5 generation utilities as described above create the actual Domain Objects with their 
groups of related Attributes. Thus, developers may create new Domains, and add 
Attributes to their existing Domains, by modifying these XML Schema files and 
generating the appropriate Java code. XML Schema files include basic attribute 
constraints (e.g., value ranges, list of valid values, attribute naming, formatting, etc.) 
10 that are turned into TypeMetaData objects, as well as textual comments that are 

converted into Java documentation to define the intent of the attribute (or method, in 
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the case of Domain methods). In some cases, Java code is embedded in the document 
and used inline in the generated Java classes for the Domain. 

Table XVH below shows the result when the above XSDL document is used to 
type the elements in the XML document source. Note that the type for lat, Ion, and alt 
5 are now Double instead of String- 



Table XVII 

LEIF Data Item - tracks 
LEEF Data Item - track 

Attribute - name : String value= J FIR3T 
Attribute - country : String value= > US > 
Attribute - category : String value= 5 SUB' 
Attribute - threat : String value='HOS' 
LEEF Data Item - position 

Attribute - lat : Double value= , 10.0 > 
Attribute - Ion : Double value='10.0' 
Attribute - alt : Double value=' 10.0' 
LEIF Data Item - track 

Attribute -name : String value=' SECOND' 
Attribute - country : String Yalue='US' 
Attribute - category : String valued AIR/ 
Attribute - threat ; String value='FRT 
LEIF Data Item - position 

Attribute - lat : Double value='20.0' 
Attribute - Ion : Double value='20.0' 
Attribute - alt : Double value='20.0' 
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The following table (Table XVIII) sbows an exemplary XSLT document. 



Table XVin 

<xsl:for-each select= ,, xsd:eleinent ,t > 
<xsl:choose> 

<xsl:when test="@name== l position ,fr > 
<xsl:copy> 

<xsl:apply-templates select="@*"/> 
<annotation> 
<appinfo> 
<domainmap 

domainfield^ ,! com.xis.domains.geo.GeoDomainlatLonAlt" 

converter^^DegreesToLatLonAltConverter" 

parameters="lat,lon,alt" 

]abel="Positioii" 

> 

</appinfo> 
</annotation> 
<V f xsl:copy> 
</xsl:when> 
<xsl:otiberwise> 
<xsl:copy> 

<xsl:apply-templates select= M @*"/> 
</xsl:copy> 
</xsl:otherwise> 
</xsl:choose> 
</xsl:for-each> 
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When such a transformation is used with the previous XSDL source shown 
above, used to type the XML document source, the result is shown in Table XDC 
below. 



Table XEX 

LEIF Data Item - tracks 
LEEF Data Item - track 

Attribute - name : String value='FIRST' 
Attribute - country : String value='U3 5 
Attribute - category : String value^'SUB' 
Attribute - threat : String value^'HOS* 
Attribute - position : LatLonAlt <- now mapped to 
GeoDomain.latLonAIt 
LEIF Data Item - track 

Attribute - name : attribute value= 9 SECOND > 
Attribute - country : String value^'US' 
Attribute - category : String value=' AIR* 
Attribute - threat : String value- FRF 
Attribute - position : LatLonAlt <- now mapped to 
GeoDomain.latLonAlt 



Note that position has been mapped to GeoDomain.latLonAlt, meaning, it is 
now a LatLonAlt type. The lat, Ion, and alt attributes are still the same, but the 
position itself may now be dealt as a single LatLonAlt object rather than a generic 
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data item with three Double fields. The use of XSLT also enables the mapping of 
XML elements into TypeMetaData, such as the LatLonAltTypeMetaData in order 
have better manipulation of the data. 

In one embodiment of the invention, the XIS framework has a "remote" 
5 capability enabling referral to an XIS session, or the data within it, from a remote 
virtual machine. Primarily, this means that data retrieval and sharing is the basis for 
export and collaboration. Secondarily, it supports operating on data within XIS from 
a remote virtual machine, perhaps on information existing only at that remote virtual 
machine. 

10 In another embodiment, SOAP (Simple Object Access Protocol) may be 

utilized. SOAP is a messaging framework that defines a protocol for the exchange of 
information in a decentralized, distributed environment. See, for example, the W3C 
Web site at http://www.w3.org/TR/SOAP. SOAP provides an instantiation of the 
remote capability, and is used to enable a general-purpose means of mating together 

15 or communicating among distributed sessions. These sessions may be two full XIS 
sessions on separate servers, or may comprise one XIS server and one XIS client, or 
may be used to. interface XIS to otherwise very different software, even including 
software applications written in different programming languages and running on 
incompatible operating systems. All data and remote procedure calls are made 

20 through XML. Those skilled in the art will be understand that SOAP is an XML- 
based protocol. The working draft of this specification is currently being developed 
bytheW3C. 

In another embodiment, remote references are used. These references are 
persistable or persistent references to XIS data. In a distributed context XIS uses 
25 XML representations of the references to share, persist, or identify particular data. 
Embedded in the XML are custom information enabling determination of data 
location in files or databases, on web servers, or based on unique Ids or names within 
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the XIS session, or based on data which are passed to a constructor, or on an ECMA 

•» 

script that can re-generate the data object 

In another embodiment, the data representation in the remote distributed 
sessions is all based on the XIS mediation layer. All data, regardless of the initial 
5 type, is.passed and manipulated as sets of attributes and relationships. This greatly 
enhances portability and interoperability of the data. At the same time the data 
contains a global unique identifier, so the individual and specific source and identity 
of that data is maintained in spite of having been translated to a mediated format. 
In another embodiment, a metadata type, e.g., ''Constructor Scripts," is used. 

10 This metadata type supports the generation of ECMA Script scripts to restore a 
TypeMetaData (metadata type) object at a later time. By executing the script, the 
TypeMetaData is restored to its exact state. The advantage over standard Java object 
serialization is control over the save/restore process, and the ability to represent the 
state in fairly readable text format. 

15 Distributed Multi-user Collaboration 

Figure 31 is a schematic diagram of the second set of facilities that allows 
users at remote computers to collaborate through shared views of the same data. It 
also shows objects and methods that may be involved in distributed collaboration 
facilities. Visual consumer components (e.g., INFOBEANs) are condensed and 

20 compressed so that they may be efficiently accessed by a remote computer and then 
locally displayed. This is done using a MetaView object, which encapsulates the 
essential elements of a visual component to allow reconstruction on another screen 
with minimum requirement for data transmission. MetaViews are manipulated using 
the relationship handling machinery of the framework as discussed above; in 

25 particular, an indirect reference to the MetaView is produced and passed around to 
remote consumers, who need only resolve the reference and retrieve the MetaView 
object if the user requests the display. 
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An event-handling schema is introduced for transmission of changes in the 
view from one computer to all others that are joined to the session. View 
management is accomplished via a "tree" display showing hierarchies of local views, 
sessions, and shared views (including properties and subsidiary data items). Views 

5 may be shared through the intuitive action of dragging and dropping them from one 
branch on the tree to another. Multicast protocols may be used so that MetaViews, 
LeifReferences (references), and Event objects may be transmitted directly from one 
computer to another without the need to go through a server. Alternatively, HTTP 
protocols may be employed if security and firewall considerations make multicasting 

10 impractical. 

Metadata Server Facilities 

Figure 32 shows a third set of facilities that allows remote consumer software 
objects 3220 to obtain additional annotations on information that is encountered along 
with at least a minimal self-description component, as may be found, e.g., in an XML 

15 tag name. These facilities are targeted to be useful to software agents 3202 in 
particular. (See Wooldridge, M., Jennings, N. (1995); "Intelligent Agents: Theory 
and Practice" in Knowledge Engineering Review 10:2.) For example, a Java software 
agent may occasionally encounter data objects or request terms, which were not 
anticipated when the agent was programmed. The tag name or other descriptive 

20 annotation (connector) 3206 is used as a key to request metadata and possibly domain 
policy methods defined within XIS from a known server, called a semantic repository 
3204. The server 3204 checks its index for a match; if a match is not found, it can 
optionally ask a predicate logic inference engine 3208 to provide alternate names to 
search under (e.g., "cat, large, ferocious" is returned from the inference engine in 

25 response to a request for "lion"), which are then also compared to the index. If a 
match is found, the server returns the appropriate metadata and possibly domain 
policy method(s) to the requesting agent 3202, making use of either Sun's Jini 
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framework or Java's built-in provisions 3222 for network transfer and subsequent 
dynamic loading of classes (including, e.g., procedural components of the metadata 
and methods) to transfer the actual code procedures into the running agent. These 
transferred information can then be used by the agent 3202 to aid in handling the 
5 object. For example, an agent can display an unanticipated data type to a user by 
calling the renderer method thus returned from the semantic repository. The semantic 
repository may also interface with other repositories 3212 via a data network 3210, 
. such as a wide area network (WAN) 3210. 

In the above embodiment, information metadata and even information access 
10 software may be dynamically downloaded from remote sources ("semantic 

repositories" or "Metadata Server Facilities"), e.g., from the data source itself or from 
an intermediary server. This is a unique feature particularly as applied to XIS 
metadata, domain policies, and DSIs. 

One skilled in the art will further understand that the common representation of 
15 and access to information from internal APIs (mediation layer) may be exported to 
distributed application in support of middleware architectures for scalability or other 
advantages, and in support of collaboration by sharing data and data changes 
(permanent or transient) with other distributed collaborators. 

The present invention also supports user "transfer" of objects from one context 
20 (e.g., between two INFOBEANs) via drag/drop, cut/paste, and other mechanisms. 
Transfers of objects apply only to non-contextual information. Thus, each view has 
its own InfoModel that provides tie contextual information for that view alone. 
Example 5 below further explains this idea. 
Example 5 

25 The Example 5 application is contained in three Java source files, 

HelioWorldjava, HelloWorldTranslator.java, and TestHarness.java. The source files 



97 



WO 02/46916 



PCT/US01/48418 



for this Example are explained below* The resulting outputs are shown in Figures 
38A and 38B. Non-contextual information is transferred in this Example. 

The Java source files in Example 5 modify those from Example 3 or 4 to 
demonstrate the use of drag and drop facilities within XIS, along with a more 
5 complex view. As before, changes from the previous step are marked by open and 
close commented braces. 

The table below (Table XX) shows a code snippet that replaces a portion of 
code in the HelloWorldjava file shown in Example 3. The code portion below 
replaces the portion of code 2102 found in Figure 21 to implement Example 5. 

10 

Table XX 

/*{*/ 

private String myName; 
public Hello World(String myName) { 
this.myName ~ myName; 

} 

public String toStringO { 
return myName; 

} 

/*}*/ 



With the above modification, the HelloWorldjava file for this Example has 
been enhanced so that instances can be given names upon creation, and this name is 
15 returned by the toStringO method. Also, the getlDO method has been removed. 
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The HelloWorldTranslator.java file for this Example is similar to the 
HelloWorldTranslator.java file shown in Figures 22A to 22C, except that this source 
file has been simplified from the previous version by removing the "course" attribute. 
Figures 37A to 37D list the TestHarness Java source file, where the bulk of the 
5 changes are coded. First of all, it contains an import to help lay out multiple 

components within a Jframe 3702, and also imports for two new XIS INFOBEANs: a 
Table bean and a Tree bean 3704. The tree bean displays data items and any member 
data items they contain, and enables users to select and perform various functions on 
1 them such as editing their properties. The table bean displays the attributes of 
10 multiple data items in a user-configurable way. 

The first portion of new code 3706A and 3706B initializes several HelloWorld 
objects and inserts them into an array. The table and plot INFOBEANs are initialized 
and placed side-by-side in a JFrame. They are not loaded with any data items, but 
items can be dragged onto them when the application is running. The next thing is 
15 that a tree INFOBEAN is initialized and loaded with the array, and it is put up in its 
own JFrame. 

This Example 5 application puts up two windows-the first is a Tree 
INFOBEAN containing several HelloWorld data items. The second has two frames, 
on the left a Table INFOBEAN, on the right a Chart INFOBEAN, both of which are 

20 initially empty. The table is initially completely blank because it has no information 
on what headings are appropriate, while the plot displays a default grid. 

In the tree display, a user may select data items or open and close them, similar 
to the directory tree view provided by the "Windows Explorer" application. In this 
case, the only item that contains anything is the root, which is a special data item. 

25 Double-clicking on it opens or closes it, but it cannot itself be selected Right clicking 
on an item (but not the root) brings up a menu of operations that may be performed on 
it In particular, selecting 'Properties' brings up a property sheet window (as in the 
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previous examples) for that particular instance. A user may left-click-and-drag on 
data items from the property sheet window over to the table or the plot 

The table automatically sets up columns for the preferred attributes of the data 
items dragged onto it. The layout may be changed interactively by either dragging on 
5 the headings or their boundaries, or by right clicking on the headings. Double 

clicking on the attributes enables a user to edit them. Items may also be dragged from 
the table onto the plot as well, or in the other direction. The selection and pen color 
attributes are kept aligned automatically between all views of the same data item. A 
user exits the application by closing the tree window. 

10 Data item commands, also known as JAF Commands (based on "JavaBeans 

Activation Framework") may also be implemented within XIS. The JAF API is a part 
of Java and provides a way to associate commands with object. By using JAF, 
developers may take advantage of standard Java interfaces to determine the type of an 
artitrary piece of data, encapsulate access to it, discover the operations available for it, 

15 and to instantiate the appropriate bean to perform said operations). For example, if a 
browser obtained a JPEG image, JAF would enable the browser to identify that the 
stream of data is a JPEG image, and from that type, the browser could locate and 
instantiate an. object that could manipulate, or view that image. JAF commands are 
typically used in pop-up menus or menu bars to control objects. 

20 XIS uses JAF commands to control DSIs and perform operation on data items. 

Right clicking on a data item in an InfoBean pops up a menu with commands that are 
specific to that data item. JAF commands with XIS may implement the following: 

- "Context Menus" or pop-up menus initiated by right clicking on a 
25 display that represents one (or more) data items; 
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- Command "menus" may be combined into a menu for multiple objects 

(e.g., one single command (menu item) to delete all selected 
objects; 

- Addition of data item commands per object type by adding them to the 

"JAF" registry; 

- Addition of file/content MIME types in the display; 

- Addition to the "JAF" registry of entries that represent objects that can 

add any number of menu items dynamically; 

- JAF commands may be added by "Menu Populators" that can add 

menu items for single and multiple data items; 

- JAF commands may be added by the environment for other typical 

functions that might be performed on any object (possibly 
depending on capabilities/content of that data item), e.g., 
Copy/Paste/Cut/Delete, Hide/Show, Refers To (if the object 
exposed relationships to other objects which may or may not be 
loaded yet), Contains, Referred by, Contained by, URLs 
(attributes), Properties, etc.; and 

- Default behavior of "Properties" command may be overridden using a 

"JAF entry." 

Figures 38A, 38B, 38C, and 38D show how JAF is used within the framework. 
Figure 38A shows a menu of HeUoWorld objects for selection, displayed on a screen 
of the computer system implementing the framework. Figure 38B shows that the 
HeUoWorld objects are displayed through a graphing (data plot) viewer. Figure 38C 
shows the display of Figure 38B after the display cursor has been positioned over the 
bar graph, followed by a right-click. A context menu, enabling the user to select the 
"Properties" option, is displayed in Figure 38D. In this example, the HelloWorld 
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object can be manipulated by a PropettySheetlnfoBeaa object Thus, selecting the 
"Properties" option results in a PropertySheetlnfoBean being instantiated showing the 
properties of the First HelloWorld object, as shown in Figure 38D. 

Another feature provided by the XIS framework is the use of attribute aliases. 
5 This enables one attribute from one domain to be substituted for an attribute in 
another domain. For illustration purposes, let us assume that we have two domains 
called Movement Domain and Physics Domain. The attribute speed in knots is 
defined in the Movement Domain, while the attribute velocity in meters/sec is defined 
in the Physics Domain. The XIS framework enables a developer to register or define 

io that the speed attribute in the Movement Domain is similar or compatible with the 
velocity attribute in the Physics Domain. Thus, enabling a data consumer object to 
ask for the Attribute from the domain that it knows about, and have the value 
translated from the Attribute of the DSI from the second domain. 

Figure 39A, 39B, and 39C show details of an exemplary embodiment 

15 explaining how an interface for the attribute alias feature described above may be 
defined or implemented within the XIS framework. The illustration includes class 
listing for objects that are used in the preferred embodiment of the framework. 

Figure 40 is a block diagram of a computer that may be used to implement the 
framework described herein. The framework may be used in a single computer, or 

20 may be used in conjunction with one or more computers that may communicate with 
each other over a network to share data. Those skilled in the art will appreciate that 
the various data objects, framework extensions, and other processes described above 
may be implemented with one or more computers, all of which may have a similar 
computer construction to that illstrated in Figure 40, or may have alternative 

25 constructions consistent with the capabilities described herein. 

Figure 40 shows an exemplary computer 4000 such as might comprise a 
computer in which an object oriented programming environment is supported to 
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permit the framework operations described above, and to permit the various display 
operations and computer processing events. Each computer 4000 operates under 
control of a central processor unit (CPU) 4002, such as a "Pentium" microprocessor 
and associated integrated circuit chips, available from Intel Corporation of Santa 
5 Clara, California, USA, A computer user can input commands and data from a 
keyboard and computer mouse 4004, and can view inputs and computer output at a 
display 4006. The display is typically a video monitor or flat panel display. The 
computer 4000 also includes a direct access storage device (DASD) 4008, such as a 
hard disk drive. The memory 4010 typically comprises volatile semiconductor 

10 random access memory (RAM). Each computer preferably includes a program 

product reader 4012 that accepts a program product storage device 4014, from which 
the program product reader can read data (and to which it can optionally write data). 
The program product reader can comprise, for example, a disk drive, and the program 
product storage device can comprise removable storage media such as a magnetic 

15 floppy disk, a CD-R disc, a CD-RW disc, or DVD disc. 

The computer 4000 can communicate with other computers over a computer 
network 4016 (such as the Internet or an intranet) through a network interface 401 8 
that enables communication over a connection 4020 between the network 4016 and 
the computer 4000. The network interface 40 18 typically comprises, for example, a 

20 Network Interface Card (NIC) or a modem that permits communications over a 
variety of networks. 

The CPU 4002 operates under control of programming steps that are 
temporarily stored in the memory 4010 of the computer 4000. When the 
programming steps are executed, the computer performs its functions. Thus, the 

25 programming steps implement the functionality of the event tracking process 
described above. The programming steps can be received from the DASD 4008, 
through the program product storage device 4014, or through the network connection 
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4020. The program product storage drive 4012 can receive a program product 4014, 
read programming steps recorded thereon, and transfer the programming steps into the 
memory 4010 for execution by the CPU 4002. As noted above, the program product 
storage device can comprise any one of multiple removable media having recorded 
5 computer-readable instructions, including magnetic floppy disks and CD-ROM 
storage discs- Other suitable program product storage devices can include magnetic 
tape and semiconductor memory chips. In this way, the processing steps necessary 
for operation in accordance with the invention can be embodied on a program 
product, 

io Alternatively, the program steps can be received into the operating memory 

4010 over the network 4016. In the network method, the computer receives data 
including program steps into the memory 4010 through the network interface 401 8 
after network communication has been established over the network connection 4020 
by well-known methods that will be understood by those skilled in the art without 
• 15 further explanation. The program steps are then executed by the CPU 4002 thereby 
comprising a computer process. 

It should be understood that the any device that supports the framework 
envirnonment described above, acting as a host computer, will typically have a 
construction similar to that shown in Figure 40, so that details described with respect 

20 to the Figure 40 computer 4000 will be understood to apply to all computers of any 
network system in which the framework or framework-developed applications are 
utilized. Alternatively, the devices can have an alternative construction, so long as the 
computer can communicate with the other computers and can support the 
functionality described herein. 

25 All patents, patent applications, publications and references mentioned in the 

specification are indicative of the practice level of those skilled in the art to which the 
invention pertains. All patents, patent applications, publications and references are 
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herein incorporated by reference to the same extent as if each individual patent, patent 
application, publication or reference was specifically and individually indicated to be 
incorporated by reference. 

One skilled in the art should readily appreciate that the present invention is 
well adapted to carry out the objects and obtain the ends and advantages mentioned, 
as well as those inherent therein. The specific embodiments described herein as 
presently representative of preferred embodiments are exemplary and are not intended 
as limitations on the scope of the invention. Changes therein and other uses will 
occur to those skilled in the art which are encompassed within the spirit of the 
invention are defined by the scope of the claims. It will be Teadily apparent to one 
skilled in the art that modifications may be made to the invention disclosed herein 
without departing from the scope and spirit of the invention. 

The present invention has been described above in terms of presently preferred 
embodiments so that an understanding of the present invention can be conveyed. 
There are, however, many configurations for information system frameworks not 
specifically described herein but with which the present invention is applicable. The 
present invention should therefore not be seen as limited to the particular 
embodiments described herein, but rather, it should be understood that the present 
invention has wide applicability with respect to information systems generally. All 
modifications, variations, or equivalent arrangements and implementations that are 
within the scope of the attached claims should therefore be considered within the 
scope of the invention. 

«3 
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CLAIMS 

We claim: 

5 

1 . An extensible framework for use in a computer system that supports an 
object oriented programming environment and includes a memory in which data 
objects can be stored, the framework comprising a set of object classes that can be 
extended using object oriented principles to define an information handling 

10 application with data objects comprising a class of data source objects and a class of 
data consumer objects, and a mediation layer that defines an interface between the 
data source objects and the data consumer objects to permit data communications 
between the two data object classes, such that the class configuration of the data 
source objects can be specified independently of the class configuration of the data 

15 consumer objects. 

2. A computer system that supports an object oriented programming 
environment and includes access to data storage containing specifications for a set of 
object classes that can be extended using object oriented principles to define an 

20 information handling application with data objects comprising a class of data source 
objects and a class of data consumer objects, and a mediation layer that defines an 
interface between the data source objects and the data consumer objects to permit data 
information exchange between the two data object classes, such that the class 
configuration of the data source objects can be specified independently of the class 

25 configuration of the data consumer objects. 
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• 3. A computer system as defined in claim 2, wherein the mediation layer 
defines a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

4. A computer system as defined in claim 3, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

5. A computer system as defined in claim 3, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 
data source class objects. 

6. A computer system as defined in claim 3, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

7. A computer system as defined in claim 3, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

8. A computer system as defined in claim 4, further including a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 
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9. A computer system as defined in claim 8, further including a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

10. A computer system as defined in claim 6, wherein an attribute alias may 
be specified by a user to indicate any data source attributes of an attribute domain that 
may be substituted with attributes of a different attribute domain. 

11. A computer system as defined in claim 4, wherein said 
attribute/metadata interface provides input/output functions for display and editing of 
the attribute during runtime. 

12. A computer system as defined in claim 4, further including a 
FieidMetaData attribute that specifies processing criteria for an attribute of a data 
object 

13. A computer system as defined in claim 4, wherein the processing 
criteria relates to a selected attribute of the data object for display processing. 

14. A computer system as defined in claim 5, wherein the indicated 
relationship may be resolved using a version of the Relationship object in cache of the 
computer system. 

15. A computer system as defined in claim 2, further including a 
collaboration facility that permits a user at a network computer remote from the 
computer system to share a view of a data object at the remote network computer. 
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16. A computer system as defined in claim 15, wherein the collaboration 
facility comprises a MetaView class of data objects that lightweight encapsulate 
elements of a data object for visual reconstruction on a display screen of the remote 
network computer. 

5 

17. A computer system as defined in claim 4, wherein the data interface 
provides an override function that can override default metadata of the data object 
attributes. 

10 18. A computer system as defined in claim 6, wherein the data interface 

provides an override function that can override default metadata of the data object 
attributes. 

19. A computer system as defined in claim 3, wherein data objects provided 
15 through the data interface comprise information that specifies data attributes, 

relationships, event broadcasting of changes in all registered data consumer objects, 
metadata for attributes that provide declarative and procedural information and/or 
input/output functions for display and editing, and related data items, and wherein the 
data objects can store references without direct access to a related data item. 

20 

20. A computer system as defined in claim 19, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata. 

25 21. A computer system as defined in claim 3, wherein the mediation layer 

further includes object classes that include one or more methods that provide data 
exposure, and further including a Data Source Interface object class of data objects 
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with methods that automatically determine which data exposure method will be used 
for data communications between the data source objects and data consumer objects. 

22. A computer system as defined in claim 21 , wherein the determined data 
5 exposure method comprises data object reflection and introspection. 

23 . A computer system as defined in claim 2 1 , wherein the data exposure 
methods include a data source object method that provides a standard interface, a data 
source object and a Translator object that maps an alternate data interface to the 

10 standard interface, and a data source object that is inspected by the computer system 
to determine available data fields which are thereby exposed to data consumer objects 
by the standard interface. 

24. A computer system as defined in claim 3, wherein the data interface of 
1 5 the mediation layer provides a wrapper for the data objects. 

25. A computer system as defined in claim 24, wherein data exchange 
occurs without providing contextual data characteristics to a receiving data object. 

20 26. A computer system as defined in claim 25, wherein the contextual data 

characteristics are supplied by the data object wrapper. 

27. A computer system as defined in claim 3, wherein data exchange occurs 
without providing contextual data characteristics to a receiving data object 

25 

28. A computer system as defined in claim 2, further including a plug-in 
manager object class that integrates service components into the application. 
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29. A computer system as defined in claim 28, wherein data service 
components interact with other components of the application to determine if a 
service is required and to determine parameters that are to be interchanged 

5 

30. A computer system as defined in claim 29, wherein the service 
determination occurs upon introduction of newly loaded components. 

3 1 . A computer system as defined in claim 3, fiirther including a translator 
10 facility that translates information concerning a data object into (1) attributes and 

metadata that define groups of data source and data consumer class attributes and (2) 
an object class that specifies at least one domain method for defining groups of data 
object attributes. 

15 32. A computer system as defined in claim 24, further including an 

InfoModel data object class. 

33, A computer system as defined in claim 27, wherein said contextual data 
characteristics are supplied by an InfoModel object 

20 • 

34. A computer system as defined in claim 33, wherein the InfoModel 
object receives a data source object for exposure to the data consumer objects, selects 
available attributes and methods of the received data source object for data 
characterization, and determines if the addition of attributes or methods to the data 

25 source object are appropriate. 
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35. A computer system as defined in claim 6, wherein the domain is defined 
using XML schema. 

36. A method of communicating data in a computer system that supports an 
5 object oriented programming environment and includes data storage or access to data 

storage containing data objects and specifications for a set of object classes that can 
be extended using object oriented principles to define an information handling 
application, the method comprising: 

receiving one or more data objects comprising a class of data source objects; 
10 representing the data source objects in accordance with an Information Model 

class of objects of a mediation layer that defines a data interface between the data 
. source objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
15 that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

37. A method as defined in claim 36, further including specifying at least 
one attribute/metadata object class that specifies attributes, including metadata, and 

20 that provides declarative and procedural information relating to attributes in said data 
object. 

38 A method as defined in claim 36, further including specifying a 
Relationship object class or classes that specify relationships between data source 
25 objects. 
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39. A method as defined in claim 36, further including specifying a Domain 
Policy or Domain object class or classes that specify a group of related attributes, 
methods, and semantic information that indicates data processing to be available for 
the specified attributes, including the specific intent of said attributes. 

40. A method as defined in claim 36, further including specifying an Event 
Change object class or classes that specify change event registration for detecting 
changes in the data objects. 

41 . A method as defined in claim 37, further including specifying a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 

42. A method as defined in claim 41, further including specifying a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

43. A method as defined in claim 39, further including specifying an 
attribute alias by a user to indicate any data source attributes of an attribute domain 
that may be subtitued with attributes of a different attribute domain. 

44. A method as defined in claim 37, wherein the attribute/metadata 
interface provides input/output functions for display and editing of the attribute during 
runtime. 
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45. A method as defined in claim 37, wherein the attribute/metadata object 
class is a FieldMetaData attribute that specifies processing criteria for an attribute of a 
daia object. 

46. A method as defined in claim 37, wherein the processing criteria relates 
to a selected attribute of the data object for display processing. 

47. A method as defined in claim 38, wherein the indicated relationship 
may be resolved using a version of the Relationship object in cache of the computer 
system. 

48. A method as defined in claim 36, further including providing a 
collaboration facility that permits a user at a nework computer remote from the 
computer system to share a view of a data object at the remote network computer. 

49. A method as defined in claim 48, wherein the collaboration facility 
comprises a MetaView class of data objects that lightweight encapsulate elements of a 
data object for visual reconstruction on a display screen of the remote network 
computer. 

50. A method as defined in claim 37, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 

51. A method as defined in claim 39, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 
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52. A method as defined in claim 36, wherein data objects provided through 
the data interface comprise information that specifies data attributes, relationships, 
event broadcasting of changes in all registered data consumer objects, metadata for 
attributes that provide declarative and procedural information and/or input/output 
5 functions for display and editing, and related data items, and wherein the data objects 
can store references without direct access to a related data item. 



53. A method as defined in claim 52, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 

l o with respect to the contextual metadata. 

54. A method as defined in claim 36, wherein the mediation layer further 
includes object classes that include one or more methods that provide data exposure, 
and farther including a Data Source Interface object class of data objects with 

15 methods that automatically determine which data exposure method will be used for 
data communications between the data source objects and data consumer objects. 

55. A method as defined in claim 54, wherein the determined data exposure 
method comprises data object reflection and introspection. 

20 

56. A method as defined in claim 54, wherein the data exposure methods 
include a data source object method that provides a standard interface, a data source 
object and a Translator object that maps an alternate data interface to the standard 
interface, and a data source object that is inspected by the computer system to 

25 determine available data fields which are thereby exposed to data consumer objects by 
the standard interface. 
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57. A method as defined in claim 36, wherein the data interface of the 
mediation layer provides a wrapper for the data objects. 

58. A method as defined in claim 57, wherein data exchange occurs without 
5 providing contextual data characteristics to a receiving data object 

59. A method as defined in claim 58, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

10 60. A method as defined in claim 36, wherein data exchange occurs without 

providing contextual data characteristics to a receiving data object. . 

61 . A method as defined in claim 36, further including a plug-in manager 
object class that integrates service components into the application. 

15 ■ 

62. A method as defined in claim 61, wherein data service components 
interact with other components of the application to determine if a service is required 
and to determine parameters that are to be interchanged. 

20 63 . A method as defined in claim 62, wherein the service determination 

occurs upon introduction of newly loaded components. 

64. A method as defined in claim 36 , further including a translator facility 
that translates information concerning a data object into (1) attributes and metadata 
25 that define groups of data source and data consumer class attributes and (2) an object 
class that specifies at least one domain method for defining groups of data object 
attributes. 
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65. A method as defined in claim 57, further including an InfoModel data 
object class. 

5 66. A method as defined in claim 60, wherein said contextual data 

characteristics are supplied by an InfoModel object. 

67. A method as defined in claim 66, wherein the InfoModel object receives 
a data source object for exposure to the data consumer objects, selects available 

10 attributes and methods of the received data source object for data characterization, 
and determines if the addition of attributes or methods to the data source object are 
appropriate, 

68. A method as defined in claim 39, wherein the domain is defined using 
15 XML schema. 

69. A computer system that supports an object oriented programming 
environment, the system comprising; 

sl processor that executes program instructions to provide the object oriented 
20 programming environment; and 

data store means for providing program instructions containing specifications 
for a set of object classes that can be extended using object oriented principles to 
define an information handling application with data objects comprising a class of 
data source objects and a class of data consumer objects, and a mediation layer that 
25 defines an interface between the data source objects and the data consumer objects to 
permit data information exchange between the two data object classes, such that the 
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class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 

70. A computer system as defined in claim 69, wherein the mediation layer 
5 defines a data interface that provides an information exchange standard between the 

data source objects and the data consumer objects. 

71 . A computer system as defined in claim 70, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 

i o metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

72. A computer system as defined in claim 70, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 

15 data source class objects. 

73. A computer system as defined in claim 70, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 

20 available for the specified attributes, including the specific intent of said attributes. 

74. A computer system as defined in claim 70, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

25 

75. A program product for use in a computer system that executes program 
instructions recorded in a computer-readable media to perform a method for 
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information exchange in a computer system that supports an object oriented 
programming environment and includes access to data storage containing data 
objects, the program product comprising: 
a recordable media; and 

a program product of computer-readable instructions executable by the 
computer system to perform a method comprising: 

receiving data specifications for a set of object classes that can be extended 
using object oriented principles to define an information handling application, 
wherein the extended objects provide an information handling application that can 
receive one or more data objects comprising a class of data source objects, and 
represent the data source objects in accordance with an Information Model class of 
objects of a mediation layer that defines a data interface between the data source 
objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

76. A program product as defined in claim 75 , wherein the method further 
includes specifying at least one attribute/metadata object class that specifies attributes, 
including metadata, and that provides declarative and procedural information relating 
to attributes in said data object 

77. A program product as defined in claim 75, wherein the method further 
includes specifying a Relationship object class or classes that specify relationships 
between data source objects. 
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78. A program product as defined in claim 75, wherein the method further 
includes specifying a Domain Policy or Domain object class or classes that specify a 
group of related attributes, methods, and semantic information that indicates data 
processing to be available for the specified attributes, including the specific intent of 

5 said attributes. 

79. A program product as defined in claim 75, further including specifying 
an Event Change object class or classes that specify change event registration for 
detecting changes in the data objects. 

xo 

80. A method of operating a computer system to execute an information 
handling application in an object oriented programming environment and to receive 
data from a class of data source objects and provide a class of data consumer objects 
with data, the method comprising: 

15 selecting available attributes and methods of a data source object for 

characterization; 

determining attributes or methods to be added to the data source object during 
application execution; and 

receiving the data source object and determining whether to expose or hide 
20 available attributes and methods of the object from data consumer objects, wherein 
data communications between the two data object classes is supported, such that the 
class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 
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Package com.xis.types 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of those types. 



See: 

D escription 



Interface Summary 


DataTest 


The DataTest interface specifies methods for Object validation. 


ZWLTypslO 


This interface defines the 10 for HTML. 


SMmmMiyfMnfiiQit 


The Summacyxunction interface defines generic summary functionality based upon provided 
input data values. 


SmngTypeJP. 


The SwingTypelO interface allows for the use of both swing editors, allowing swing 
components to edit an object, and swing rendcrers, which know how to render these objects in 
a swing environment. . 


TextlmlQ 


Tne TextTypelO interface provides a means of formatting objects in a textual fashion, as well 
as parsing text from which an object is created. 


TvpedValue 


me lypeavaiue invcuacc is ussu 10 noiu an ooject mat cames its own typeivieuiuata %YttH 
it • " • 


TypeEditor 


The TypeEditor interface defines methods for editing attributes provided by the types 
implemented within this package. * 


TypelQ 


The TypelO interface provides a common base from which other TypelOs can extend, such as 
HTMt/TypeI.0, SwingTypelO, etc. ■ . * 


TypeMetaData 


The TypeMetaData interface defines generic type accessors for object comparing, editing, 
formatting,. rendering, and validation. - 


TypeMetaData Factory 


The TypeMetaDataFactory interface defines a class that can create TypeMetaData for a . 
given Class Type. a • 


Type/Tenderer 


The TypeRendecec interface defines methods for rendering attributes provided by the types 
implemented within this package. . 


ValidTeztPrvxv 


The ValidTestProxy interface 


WMLTvneEdHor 


The WMLTypeEdi tor interface defines methods for rendering attributes provided by the types 
implemented within this package. 


WMLTypelQ 


This interface defines the 10 for WML format 


WMLTypeRenderer 


The HMLTypeRenderer interface defines methods for rendering attributes provided by the 
types implemented within this package. 


XMLTypelO 


The XMLTypelO interface provides a mcansof formatting objects in a XML textual fashion, as 
well as parsing XML text for creating an object 
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Class Summary 


AbstractDataTest 


The AbstractDataTest class provides a default implementation of test 
(Object) 


• 

^bslt^cilypeMeta Qaia 


Abs-tractTypeMetaData provides a partial implementation of 
TypeMetaoaca to relieve uie a.io ucvciupcr uviu cAjm«-»v*y uitpn,iu^uuti 0 
irrelevant methods. 


&rejt£rUjic^^ 


AreaOfUncertaintyTypeMataOata is a type object that supports 
AreaOJUncertainty objects. 


ArrayUstTypeMetaData 


ArrayListTypeMetaOata is a type object that supports 
JavtLutiLArrayLtii objects. 


A rra vT v p eM e ta D n ta 


ArrayTypeMetaData is a type object that supports Java, lang.reflect. Array 
objects. 


BeanTvDeM eta Data 


BeanTypeMetaData is a type object that supports Java, b eans objects. 


floolea nT vneiYf eta Da ta 


The BooleanTypeMetaData is a type object that" supports Boolean objects. 


BoolcanTvoeMetaDatnFactorx 


A BooieanTypeMetaOataFactory can create a 
BooleanTypeMetaData forgiven booteans. 


rachgdTvneMfttaDaia 


CachedTypeMetaData is a type object that simply delegates all . 
TypeMetaData calls to another TypeMetaData. 


n «ifi«i tin nTvneM eta Data 


ClassificationTypeMetaOata is a type object that supports 
Classification objects. 


roitectionsTvpeM eta_naia 


CollectionsTypeMetaDaCa is a type opject mar supports coiiecuon 
objects. 


Colo rTvoeM eta Data 


The ColorTypeMetaData class implements TypeMetaData for Color 
objects. f 




A ColorTypeMetaData Factory can create a ColorTypeMetaData for 
a given Color object. 


CflnversionNumericlMPeiVletaData 


A generic NumericTypeMetaData for converting from one unit to another. 


CurjxncjTy.^J^ajaata 


CurrencyTypeMetaData is a type ocject mat supports numoer uujecu* 
that represent Currency values. 


DateTimeTypeMetaData 


DateTimeTypeMetaData is a type object that supports Date objects. 


DateTimeTypefrtetjiPataFactonr 


A DateTimeTypeMetaData Factory can create a 
DateTimeTypeMetaData for given Date objects. 


Di^creteRAn^e5tnn&Ili?eMetajg3ta 


DiscreteRangeStringTypeMetaData is a type object that supports 
String objects with discrete ranges. 


DisplavLabelTypeMetaDa.ta 


DisplaytabelTypeMetaData is a type object that supports supports 
Display Label objects. ' 


DTGTypeMetaData 


OTGTypeMetaData is a type object that supports Date objects. 


^numerationTyoe 


Class to implement an enumeration in Java. 


EnumeratlonTvoelVletaDaJa 


The EnumerationTypeMetaData class is used to represent integer 
constants as strings to the user. 


FontTypeMetaData 


FontTypeMetaData is a type object that supports Font objects. 


HnchM^pTyppM^aData 


HashMapTypeMetaData is a type object that suppQtejw>a.utiLHashMap 
objects. 
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HashSetTvpeMetaData 


HashSetTypeMetaQata is a tvne obiect that sunoorts iavn uiil MntUSot 
objects. 


leonShapjfTy peMeta Qata 


IconShapeTvpeMesaDa^a is a tvoe obiect that sunoorts fmn^hnnt* 
objects. 


tconTxp^.etaDaU 


IconTypeMetaOata is a type object that supports /con objects. 


y n kjd.l,i5tT^peJVJ.et3 Daja 


LinkedLis cTypeMetaOata is a type object that supports 

ierva utif t inked t rr/ nhr«vfc 


Ljsilyp.eJVletaPata 


ListtypeMetaOata is a rype object that supports java.uiil.List objects. 


MftUjfiMgpProxy 


The MouseMapProay class allows TypeEdttors access to the map without 
requiring them to having any compile time knowledge of the map's 
existence. 


Liu sDSS rug.m[iarator 


An implementation of the Comparator interface that compares two objects 
tnat extend jNumoer, or tnat ootn implement Comparable, with the class of 
one assignable from the other. 


NumericTvpeMctaData 


NuiaericTypeMetaDaca 1 is a type object that supports Num b er objects. 


iVumericTypeMetaDataFactory 


A NurnericTypeMata Data Factory can create NumericTypeMetaDaca 
for a given class type or method return type. 


• 

Djyj^iP^etaData 


Ob j ectTypeMetaData is a type that supports a simple Object and is 
provided to quickly add arbitrary attribute types to a Data Source Interface 
witnoui writing 3 mors specmc type nancuer. 


PercentTvpeMetaPata 


FercentTypeMetaOata is a type object that supports Number objects that 
represent Percent(%) values. 


ProbabilUyTypefVjetaData 


ProbabilityTypeMetaData is a type object that supports Number 
objects that represent Probability values. 


BcjLam4Tzn^eiaP.aia 


RenamedTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getNameQ, which is overridden with 
the given value. 


Resjzejo^^ 


ResizedTextTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getPixelWidthO, which is overridden 
with the given value. 


Resources 


The Resources class is automatically generated and must be pub tic, but it 
is intended to be used only by Java's internationalization support classes. 


SmnrtPu rationTypeM etaData 


A SmartDurationTypeMetaData for converting from one time unit to 
another based on the magnitude of the duration value. 


StnngTypeMetaData . 


S tringTypeMecaOata is a type object that supports String objects. 


StringTypeMetaDataFactory 


A StringTypeKeta Data Factory can. create a StringTypeMetaData 
for a given String object 




lexci ypenecauaca is a type u eject trial sup ports / ex/ uDjecis. 


Xxp^dValueTjp^&taMa 


rypedVaiueTypeMecaData is a type object that supports supports 

T\mari VnJtip nhipf*fc 


TypeEditprBeanContextChildSupport 


The TypeSditorEeanContextChildSupport class handles most of the 
responsibilities of a TypeEditor and a BeanContextChild. 


TvoeEditorSuDport 


The TypeEditorSupport class handles most of the responsibilities of a 
FypeEditor. 


TypelOPIuggableService 


fhe TypelOPXuggableService class is responsible for loading TypelQs. 


TvpefORegistry 


Hie TypelORegistry class is a registry for different implementations of 
fypelO classes. 



f 16. l^C 
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TvpelOSuDDort 


The TypelOSupporC provides support tor t ypetvietauatas get i ype^u 
methods. 




TypeMetaDataQelagatoc is a type object that simply delegates all 
TypeMetaData calls to another TypeMetaData. 




The TypeMetaOatafactoiryPluggableSeevice class is responsible for 
loading TypeMetaDataFactories. 


TvpeMetaOataFactonStore 


This Class stores TypeMetaDataFactories. 


XrpePreferences 


This class is used by TypeMetaData instances to pass information about 
preferred TypeMetaData objects. 




The'Types class is a holder class for the RESOURCES global variable for 
resource properties of the comjeis. types package. 


iiB.i-ly.pe(VletaData 


tfRLTypeKe taOa ta is a type object that supports URL objects. 



Exception Summary 


NoSuchEnumerationException 


Class to implement an enumeration exception in Java. 


ParseFailedExceDtion 


A earseE-ailedException is thrown (typically by TypelO objects) when it is not 
possible to parse a given String as desired. 


XestFailedExceotion 


The Testf alledException is thrown from the "testQ" method of a DataTest 
subclass when the value fails the test. 



Package com.xis.types Description 

This package contains classes that provide several standard TypeMetaData classes for describing types 
constraints, and for rendering and editing values of those types. 
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Figure 15 

HeHoWortd.java 

f* XIS Tutorial standalone sequence example 1 data class. 7 

public class HelloWorld { 
' private float value = 1.5f; 

public String toStringQ { 
return "Hello World!"; 

> 

public int getlD() { 
return 5; 

} 

public float getValue() { 
return value; 

} • • ; . • 

// uncomment this to make "value" editable 

I* ■ 
public void setValue(float value) { 
this.value = value; 

} 

*/ 

} 
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Figure 16A 



TestHamess.java 

/* XIS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax,swingJFrame; ^ 
import java.awteventWindowAdapter, 
import java.awt.event WindowEvent; 
import com.xis.propertysheet.PropertySheetinfoBean; 
import com.xis.ui.UIBeanEvent; } 
import com.xis.uLUIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 



1602 



public class TestHamess { 

public static void main(String[] args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModeLsetStartingPluglnManager(false); 

// a property sheet infobean to display HelloWorid's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawDataitem(new HeiloWorldQ); 



M604 



1606 



// add listener for 'OK,' 'cancel/ or close, which generate 'close' events -\ 
properties.addU!BeanListener( 
new UIBeanAdapterQ { I 
public void closed(UIBeanEvent event) { • > 1 608 

System.exit(O); ■ 

} 

} 

}; ' 



// a top-level frame to hold our property sheet infobean 
JFrame frame - new JFrame("HeIIoWortd Properties");, 
// add a listener for window closing 
frame.addWindowListener( 
new WindowAdapter() { 
public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 
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Figure 16B 

Continuation of TestHarness.java 



// stick the bean in the frame and display it 

frame.getContentPane().add(properties); 

frame.packO; 

frame.seiVisible(true); 



> 1610B 
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Figure 17 
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Figure 18A 

HelloWorld.java 

P XIS Tutorial standalone- sequence example 2 data class. */ 
/*{*/ 

import Java . awt.Color, 

import java.beans.PropertyChangeSupport; 

import java .beans.PropertyChangeListener; 

/*}*/ 

public class HeiloWorld { 
/*{*/ 

private int value = 1; 

private Color myCoior = Color.green; 



( If this member class helps distribute property change events, within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PropertyChangeSupport(this); 

//two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupportaddPropertyChangeListener(i); 

} ' . . 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupportremovePropertyChangeListener(l); • 



\ > 




public String toStringQ { 
return "A HeiloWorld Object"; 

} 



public String getGreeting() { 
return "Hello World!"; 

} • 



public int getlD(){ 
return 5; 

} 
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Figure 18B 

Continuation of of HelloWorld.java 



public /*{7 int /*}*/ getValueQ { 
return value; 

} 

/T/ 

public void setVafue(int value) { 
// only update and fire property change if this is really a change 
if (this, value 1= value) { 
int oldValue = this, value; 
this, value = value; 

// fire property change event to notify other XIS objects 1 
propertyChangeSupport.firePropertyCharlge{* , value M , oldValue, value); * 

} 

} 

public Color getMyCotorQ { 
return myColor; 

} 

public void setMyColort-Coior myColor) {■ 
// only update and fire property change if this is really a change 
if (this.myColor != myColor) { 
Color o!dMyColor = this, my Colon ■ 
this.myColor = myColor; 

// fire property change event to notify other XIS objects ~7 . ^ 
propertyChangeSupporLfirePropertyChangermyGoior", > 
oidMyColor, myColor); .J 



} 
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Figure 19A 

TestHarness.java 

/* XIS Tutorial. standalone sequence step 2 XIS interfacing. */ 

import javax.swing JFrame; 
import java.awtevent WindowAdapter; 
import java.awt.eventWindowEvent; 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com.xis.ui.UlBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leifjm.BaselnfoModet; 

/*C7 

import jclass.chart.JCChart; 
import com.xis.plotPtotlnfoBean; 
import com.xis.pIotchartviews.LeifChartView; 

/*}*/ ' 
public class TestHarness { . 

public static void mafn(StringQ args) { ~\ 

//the plugin manager is only required for m<pre complex applications 
// involving multiple components integrated at runtime 
BaselnfoModef.setStartingPIuglnManager{false); 

> * 
HelloWorld hello = new HelloWorldQ; 

// a property sheet infobean to display HeltoWorkfs attributes u 1 

PropertySheetlnfoBean properties = new PropertySheetinfoBean(); 
properties.addRawDataltem(heflo); 

// add a listener for 'OK' or 'cancel', which generate 'close 1 events 
properties.addUIBeanListener( 
newUIBeanAdapter(){ 
public void ciosed(UIBeanEvent event) { 
System.exit(0); 

} 

} 

>; 
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Figure 19B 

Continuation of TestHarness.java 



/*{7 



/*}*/ 



//a top-level frame to hold our property sheet infobean ^ 
JFrame propertySheetFrame = new JFrame("HelloWortd Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System.exit(0); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it v . 

propertySheetFrame.getContentPane().add(properties); Vp 
propertySheetFrame.pack(); • 7 

propertySheetFrame.setVisible(tnje); 

// now we create a plot infobean to plot HelioWorld's numeric attribute 
PlotlnfoBean plot = new PiotinfoBeanQ; 
plot.addRawDataitems(new ObjectQ { hello }); 
pfotsetChartType(JCChartBAR); ' 

//the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
//and STACKING_BAR, though not ail will- make sense in this example 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFrame("HeIIoWorid Plot*); 

// stick the plot bean in and put it up ■ - 

plotFrame.getContentPaneQ.add(plot); I 
plotFrame.pack(); " s 
plotFrame,setVisible(true); 



} 
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Figure 20 
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Figure 21 

HelloWorld.java 

r XIS Tutorial standalone sequence step 3 data class. */ 
import java.awt Color; 

// (property change support moved to HelloWorldTranslator) 

public class HelloWorld { 
private int value = 1; 
private Color myCoior = Coior.green; 

public String toString() { 

return "A HelloWorld Object"; 

} 

. public String getGreetingO { 
return "Hello World!"; 

} 

public int get!D{) { 
return 5; 

} 

. public int getVa!ue() { 
return value; 

} 

./*{*/ 

public void setValuefint value) { 
, // all the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation {unless nonXl5 
// components need to listen to PropertyChanges) 
this.value = value; 

}• 
/*}*/ 

public Color getMyColorQ { 
return myCoior; 

} 

n*i 

public void setMyColor(Coior myCoior) { 
' // just n.eed to set the value (see setValue()) 
this.myColor = myCoior; 

} 

m ■ 
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Figure 22A 



HelloWorldTranstetorjava 

I* XIS Tutorial standalone sequence step 3 data translator class. 7 

ret 

import com.xis.IeifJm,AttributeGetRequest; 
" import com.xis Jeif Jm AttributeSetRequest; 

import com.xis.Ieif.im.Domain; 

import com.xis.!eif.im.Translaton 

import com.xisJeifJm.FieldMetaData; 
. import com.xis.domains.dispIay.DispiayDomain; 

import com.xis.domains.movementMovementDomain; 

import java.awt. Color; 

public class HelloWoridTranslator extends Translator { 

// the domains from which canned attribute metadata will be taken 
// NOTE, if an attribute appears in the methods below but its domain 
// is NOT listed here, THE ATTRIBUTE WILL BE IGNORED BY XIS 
private static final DomainQ baseDomains « new Domain]] { 
DispiayDomain.getDomainO, MovementDomairugetDomainO 

}; 

1 H store info about the fieids, such as whether they are preferred or not 
J private ReldMetaDataQ field MetaDataArray; 

// Return the Domains that describe the Attributes. ' * 

public DomainQ getBaseDomains() { 
return baseDomains;. 

} 

// this method returns info on each field defined in the methods below 
^public FieldMetaDataO getReldMetaDataArrayQ { 

if (fieldMetaDataArray ™ null) { 

// initialize default metadata 
ReldMetaData dispname » new 

ReIdMetaData(DisplayDomain,dispIayName); 

ReldMetaData pencolor = new 

ReldMetaData(DisplayDomain.penColor); 

ReldMetaData speed = new 

RetdMetaData(MovementDomain.speed); 

ReldMetaData course - new 

ReldMetaData(MovementDomain.course); 



{ 
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} 



Figure 22B 

Continuation of HelloWoridTranslatorjava 

// attributes are visible ('preferred 1 ) by default; this 
// turns this off for the course attribute 
course.setVisibilfty(faise}; 

// the order we put the attributes in here determines the order 
// they appear in tables or property sheets 
fieldMetaDataArray = new FieidMetaDatafl { • 
dispname, speed, course, pencolor 

); ■ 



} 



return fieldMetaDataArray; 



mmnmmnimunmiinmuimmmmmnmmmim 

II the following methods expose attributes of the HelloWorld class; 
// instead of calling the class methods directly, XIS will access 
// everything through this translator class 

iiuiummiinmimniimiuimmiiiniuimmim ■ 

public String getDisplayName(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequest,getRawDataltem()).toString(); 

} . " ■ 

public Color getPenColor(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorld) 

attributeGetRequestgetRawDataltemO)-getMyColor(); 

public void setPenColor(AttributeSetRequest attributeSetRequest, 
Color penCoior) { 
HelloWorld helloWorid = (HelloWorld) " 

attributeSetRequest.getRawDataltem(); 
Color oldPenColor = heiloWorid.getMyColorO; 
if (IpenColor.equais(oldPenColor)) { 
helloWorld.setMyColor(penColor); 
// fire property change event to notify other XIS objects 
attributeSetRequestgetBaseDataItem().fireAttributeChanged( 
Display Domain. penCoior, oldPenColor, penCoior, true); 

> 

} 

public double getSpeed(AttributeGetRequest attributeGetRequest) { 
return (double) ((HelloWorld) 

attributeGetRequestgetRawDataltem()).getValue(); 



j 
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Figure 22C 

Continuation of HeHoWorldTranslator.jaya 

public void setSpeed(AttributeSetRequest attributeSetRequest, 
double speed) { 
HelloWorld helloWorid = (HelloWorld) 

• attributeSetRequest.getRawDataltern(); 
Double oldSpeed = new Doubte((double)helloWorld.getVaiue()); 
if (oldSpeed.doubleValueO != speed) { 
. helloWorid.setValue((int)speed); 
// fire property change event to notify other X1S objects 
a ttributeSetRequestgetBaseDataltem()JreAttributeChanged( 

MovementDomain.speed, oldSpeed, new Double(speed), true); -* 

} 



I 



1M7~ 



II this is a dummy attribute to demonstrate field metadata 
public double getCourse(AttributeGetRequest attributeGetRequest) { 
return (double) 0; 

} 

// uncomment this to allow reflection to expose additional attributes 

// (see documentation under "Fooling Around") 

// public HelloWorldTranslatorQ { • 

// introspectExcept(new StringQ {"value", "myColor"}); 

H > 



} 

ryi 
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Figure 23A 

TestHarnessjava 

I* X1S Tutorial standalone sequence step 3 XiS interfacing. */ 

. import javax.swing JFrame; 
import java.awt.event. WindowAdapten 
import java.awt.event WindowEvent; ■ * 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; 
import' com .xis . ul U I Bean Adapter; 
import comjcisJeifJm.BaseInfoMode[; 
import jcIass.chartJCChart; 
import com.xis.plotPlotlnfoBean; 
import com,xis,plot.chartviews.LeifChartView; 

r?t 

import com.xis.leif.im.TranslatorRegistry; 

import com.xis.leifjm.LeifDataltem; 

import comjcis.leif.im.lnfoModel; 

import com.xis.lejf.im.BasefnfoModel; 

import comais.domains.movementMovementDomain; 

import comais.domains.movementMovementDomainWrappen 

import com.xis.leif Jm.LeifDataltemDelegator; 

import java.lang.reflectinvocationTargetExceptiop; 

import com.xisJeifj'm.UndefinedLeifAttributeException; 

/*}*/ 

public class TestHamess { 

r?i 

protected static LeifDataltem leifHelto; 
static { 

// Register the translator for HelloWorld. In fact this is really 
// only necessary when we have not followed the standard naming 
// convention (see docs), but it can't hurt. 
TransIatorRegistjy.getTranslatorRegistry().register0.bjectSchema( 
HeiloWorld.class, HelioWoiidTranslator.class); 

ryi 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 




HelloWorld hello = new HeiloWoridQ; 
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Figure 23B 

Continuation of TestHarness.java 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetinfoBean properties = new PropertySheetlnfoBeanQ; 
properties.addRawDataltem(hello); 

// add a listener for 'OfC or 'cancer*, which generate 'close 1 events 
properties.addUIBeanUstener( 
new UiBeanAdapterO { 
public void closed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

); 

// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFramefHelloWorid Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindow!Jstener( 
new WindowAdapter() { 
public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPaneQ.add(properties); - 
propertySheetFrame.pack(); 
propertySheetFrame.setVisible(true); 
// now we create a plot infobean to plot HelloWorld's numeric attribute 
PlotinfoBean plot = new PlotlnfoBeanQ; 
plot addRawDataltems(new .ObjectQ { hello }); 
plot setChartType( JCChart BAR); 

// the alternatives are SCATTER^PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// if we do, this must consist of the attribute name preceded 
// by the fully-qualified dassname which ORIGINALLY DEFINES . 
// the attributeDescriptor - i.e., using "HeiloWorkLspeed" 
// here will NOT work! If the descriptor is not defined in a 
// domain or translator class, then it will have been defined 
// dynamically through introspection when the first instance 
// of the data item is dropped into an X1S InfoBean. 
plotsetYAxisAttribute( 
,, com.xis.domains.moveme^tMovementDomain.speed ,, ); 
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Figure 23C 

Continuation of TestHarness.java 

plotsetDynamicAdjustment(true); // so axes track value magnitude . 
pIotsetBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-level frame as before to hold our plot infobean 
JFrame piotFrame * new JFramefHelloWorid Plot"); 

//' stick the plot bean in and put it up 
p!otFrame.getContentPane().add(plot); 
p!otFrame.pack(); • 
plQtFrame.setVisible(true); 

II create a ieif Data item version of hello and start a thread that 
// will increase it 
ieifHeilo = 

BaselnfoModel.getBaselnfoModel().getLeifDatattem(helIo); 
new Accelerate(); 

ryi 

}//main 

} 

/*{*/ 

// thread to update the speed attribute on the IeifHeilo Instance we created 
class Accelerate extends Thread { 

public Accelerate() { 
super("Accelerator Thread"); 
start(); 

} 

public void run() { 

// wrap the LeifDataltem IeifHeilo in a convenience wrapper that 
// gives access to attributes within that domain, if they exist 
MovementDomainWrapper heiloMovementWrapper = 
MovementDomain.takeWrapper(TestHamessJeifHeIlo); 
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Figure 23D 

Continuation of TestHarness.java 



while (true) { 

// sleep for 0.5 seconds, then,.. 
try{ 

sleep(500); 
} catch {InterruptedException e) { 

System.exit(l); 

}' 

II ..update the speed attribute 
try{ 

he!loMovementWrapper.setSpeed( 

he!loMovementWrapper.getSpeed()+1); 
} catch (UndefinedLerfAttributeException ulae) { 

II exception if this data item doesn't have this attribute * 
System.exit(1 ); // usually we would do something better 
. } catch (InvocationTargetException ite) { 

// sweep up any exception tossed by the underlying raw item 
System.exit(1 ); // usually we would do something better 

}// while 
} // run() 
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Figure 24A 
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Figure 25A 



HeUoWorld.java 

/* XIS Tutorial standalone sequence step 4 data class. */ 

import java.awt. Colon 
/*{*/ 

import com.xis.ieifJrn.FieldMetaData; 
import com.xis.domains.display.DisplayDomain; 
import com.xis.domains.movement.MovementDomain; 
import com.xis.leif jm.Domain; 
import comJcis.leifJm.AttributeGetRequest; 
import com.xisJeif.im.AttributeSetRequest; 
import com.xis.leif.im.AttributeDescriptor; 
import java.beans. PropertyChangeSupport; 
import java.beans.PropertyChangeListener; 

public class HelloWorld { 

private int value - 1; 
private Color myColor » Color.green; 

/*{*/ 

public static AttributeDescriptor getDisplayNameDescriptorQ { 

return DisplayDomain.displayName; I lL£02L 

public static AttributeDescriptor getSpeedDescriptor() { 
return MovernentDomain.speed; . 

• } 

public static AttributeDescriptor getPenColorDescriptorQ { 

return DisplayDomain.penColor; 
} • 

ryi 

/*{*/ // this property' change support code as in step 2 /*}*/ ^ 
// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PrbpertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one ■ V 1SQl\ 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupporLaddPropertyChangeListener{l); ■ 

} 

public void removePropertyChangeListener(PropertyChangeUstener I) { 
propertyChangeSupport.removePropertyChangeListener(l); 

} 
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Figure 25B 

Continuation of HelloWofld.java 

public String toString() { 

return "A HelioWorid Object"; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

public int getlDQ { 
return 5; 

} 

public int getVa!ue() { 
return value; 

} 

/*{7 // this function as in step 2 /*}*/ 
public void setVaiue{int value) { 

II we only want to update and fire property change if really changes 
if (this.value != value) { 
int oldValue = this.value; 
this.value = value; 

// fire property change event to notify other XIS objects' 
propertyChangeSupportJirePropertyChangeCVaiue", oldVaiue, value); 

' } 
} - 

/*{*/ 

// "myColorVeiated methods changed to expose "penColor" instead 

public Color getPenColorQ { 
return myColon 

} . ' 

public void setPenColor(Color penColor) { 

// we only want to update and fire property change if really changes 
if (penColor != this.myColor) { 

Color oldPenColor = this.myColor; 

this.myColor = penColor; 

// fire property change event to notify other XIS objects 
propertyChangeSupportJrePropertyChange("penColo^ 

oldPenColor, penColor); 

} 

} 



WO 02/46916 



41/90 



PCTAJS01/48413 



Figure 25C 

Continuation of HelloWorld.java 

// expose toStringO return under a new name 
public String getDisplayNameQ { 
return toStringO; 

} 

// expose "value" under a new name 
public double getSpeedQ { 
return (double) getVafue(); 

} 

• public void setSpeed(double speed) { 

• //we only want to update and fire property change if really changes 
Double oldSpeed = new Doub!e{(double)this.getVa!ue()); 
if {speed != o1dSpeed.doubieValue()) { 
setValue((int)speed); 

// fire property change event to notify other XIS objects 
propertyChangeSupportfirePropertyChange( f, speed", oldSpeed, 

new Doubfe{speed)); 

} 

} 

/*}*/ 
>{V 

// store info about the fields, such as whether they are preferred or not 
private static FieldMetaDataQ fieldMetaDataArray; 

// this me\hod returns info on each field defined in the methods below 
public static FieldMetaDataQ getFieldMetaDataArray() { 

if (fieldMetaDataArray == null) { 
// initialize default metadata 
FieldMetaData dispname » new 

FieldMetaData(DisplayDomain.dispIayName); 
FieldMetaData pencolor= new 

FieldMetaData(DisplayDomain.penCoIor); 
FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 
// could customize the field metadata here 
fieldMetaDataArray = new ReldMetaData'Q { 
dispname, speed, pencolor 

}; 

} 

return fieldMetaDataArray; 

} 

/*}*/ 
} 
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Figure 26 
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Figure 28 
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Figure 30 
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Class ContentlnfoBean 

I . . 

+ — j a va .awt .Compo nent " 

I - * " 

+ — java . aw t^Corytainer 

I ' • • 

*--ji*va,* t gw jag t ^BBanans 
1 

+--ia vax . swing . JPaneJ, 

I . . * 

»~ com, *is . ui .Abstr actOIBean 

»— Spn-xja.leU .in^obQan^.Dataltem^nkUIBean 
I 

4- — coa,xi3.infobeans.contant,ContentInfoBean 

AU Implemented Interfaces: 

Accessible. BeanContextChtldQwner. BeanContextChildOwnerDetegator. BeanContextProxy t 
BeanContext ServicesQwner Delegatof . ClipboardUser. Data! temS ink. ImageObserver . Men uContainer . 
Serializable. StateSavable. UTBean 



public class ContentlnfoBean 
extends Datalt emSla^UlBea n 
Implements ClipboardUser 

The ContentlnfoBean class is a visual component that displays the contents of a raw data item. If no contents are 
available, it defaults to a split pane 'containing the JAF menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text, or an image. Multimedia support will soon be added. 

t 

Author: » 

Jaime Garcia, Polexis, Inc. 
See Also: 

Serialized Form 



Inner classes inherited from class jayax.swing. JPan el 

^Pa,n?^,Acce ? ^b;eJganel 



Inner classes inherited from class javax.swing. JComponent 
jqompqnant; f AcceasAble JContponent 



Inner classes inherited from class java-awt Contai ner 
Container , AccessibleAWTContainer 
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Inner classes inherited from class )aya.aTYt. Coroponent 
Component. AccesslbleAWTCQnpQpgj^ 



Field Summary 


static txR^ta^t^WteadJ* 


RESOURCES 




localized resources for this view object. 



Fields inherited from class ccm.Jcis+uLAbstractUlBefln 
uibaanLisfcsner 



Fields inherited from class javax.3wingJComponenr 

accessiblpContext , listene rList , TOOL J? I P TEXT JCEY ■ ui, 0NDEFINSD_CCM0ITION . 



Fleiiif inherited from class java .a wt.£a.rr!ppnen.$ 

aoxipM^xGNMs ni , rarcra^PAisNasHi, jjui^&asaMBii/ usm^*uiG®kt?r, iQ^^mmm. ' 



Fields inherited from interface iava.aYyUmagc JroagcObscrvcr 

AB03T . ALI.BITS , ERROR . FRAMEBITS , HSIGHT > PROPERTIES , SOMEBITS , WIDTh" 



Constructor Summary 



SoateatXnf eBean ( ) 

Default constructor that creates an empty ContentlnfoBean. 





Method Summary 


. void 


a ddRa. wOata Item ( Obi set rawDa talCam) 

Load the raw data item into the Content! afoBean. 


void 


addjia.vO at attests tobtect C 1 rawoataltems) 

Add the raw data items in the array. r 


bcoUan 


canCleaci) 

Return true if the ConterirlnfoBean has an object and it is selected 


boolean 


eanClaa.gtCbieetf.1 items) 

Return true if the specified items can be cleared 


boolean 


caaCopyO 

Return true if the ContentlnfoBean has an object and it is selected 


boolein 


caj>CpByjQbj£££U items) 

Return true if the specified items can be copied. 


boolean 


car.CutH 

Return true if the ContentlnfoBean has an object and it is selected 


be olefin 


canCuttOblect (1 items) 

Return true if the specified items can be cut 


boolean 


canJaate () 

Return true if the ContentlnfoBean can paste new objects, false if not 


Boolean 


Return true if the ContentlnfoBean can select all objects. 
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boo lea 


1 canSolectWone M 

Return true if the ContentlnfoBean can un-se!ec: all objects. 


volt 


1 clear {} 

Notify the ContentlnfoBean to remove the current raw data item only if it is selected. 


»clt 


clear (Ob-iecU! i tarns) . 
Clears the given items. 


void 


e&ms&un 

Removes the currently loaded object. 


boolean 


contains (Ob i ect, f 1 items) 

Return true if this ContentlnfoBean contains *//the objects of the given array. 


boolean 


containsComponaat ( go-coon e rt t component) 

Check if thr given component is contained by this InfoBean 


void 


cqpv {Clipboard clipboard) 

Called to invoice this Contenting Bean's copy action, which is to copy all selected data 
to the Clipboard. 


void 


copy (Clipboard clipboard/ Object f 1 items! 
Copies the given items into the Clipboard. 


protected void 


■ ? . __r-_ L .i_ fc t. IS * 

crsatecontant { ] 

Method called when there is no content to display for a raw data kern. 


vole 


c«t{Clioooard clipboard) 

Cut selected items from the ContentlnfoBean and post- them into Clipboard. 


void 


cuttCliDboard clipboard. Ob^eej;fl i tens J 

Cut the given, items from the ContentlnfoBean and post them into the given Clipboard , 
only if they occur in the ContentlnfoBean. 


protected .roneainar 


•TstConhtiinerxcirCQateatdnC index) 

Get a container with the contents of the content object at the given index, or null if the 
content type is not supported. 




g-a tCpnrarita { ) 

Fetch the currectry loaded raw data item 




oet JATJVndProoertvCcHrtDonenfc [ ) 




Get the JAFAndProperry component used by the ContentlnfoBean to display the 
contents tor raw data items that have nothing else to display. , 




cetXeifD&talbesaWenutLeifDataltem dataltem. boolean shevCut Pastel tea* ) 
Return the data item menu for a LeifDataltcm (usually the selected LeifDataltem). ' 




Return the RasourceBundle for this Content Info Bean. 


aaisstu 


ge^e.lectadObjects I ) 

Get an array of selected objects. 


void 


in<o^todelCb^ngej<4 (I 

Messaged to indicate an LnfcModel change for this InfoBean or one or mere of its 
LeifDataltems. 


boolean 


isCreatingC^tejn^ ( ) 

Check whether default content creation is set 


boolean 


isOrag£nabled( ) 

Return true if the default Drag support is enabled. 


boolean 


IsDroflSnabledO 

Return true if the default Drop support is enabled. 
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Check the selected state of the content object, if there is currently one loaded. 


boolean 


Check whether the Content Lnfo8ean is updating based on XIS events and is notifying 
X IS of raw data item attribute changes - " * 


void 


ojwfce (Clipboard clipboard) 

Paste the data Objects from the given clipboard.- 




removeAllaavGahaX teas j ) 

Remove all of the raw data items that are currently loaded 


void 


.removeRavrDataIta»(Obiect rawOa talteml 

Remove the given raw data item if it is the currently loaded raw data item 


void 


'coEavolUwDataltoas {Obi set f < rawOatalLeias) 
Remove the raw data items in the array. 


void 


Set the selection state of the object to true. 


veld 


selections O 

Set the selection state of the obj ect to false. 




sstCr eateContent {boolean creace) 

Set whether content should be created for objects that do not have any displayable 
content, via a JAFAndPropertyComponent. 


roid 


se tDragSnabled (boolean enabledrag ) 
' Set the status of the default Drag support. 


void 


set0ra<7OvmerProxv(DcaaOwneK draa Proxy 1 
Set z DragOwner "proxy* for this In fpBeaa 


void 


aetprop2nable«i(boolaan enabledroo) 
Set the status of the default Drop support 


•void 


setDrosOvnerProxvfOrocOwner dropProxyl . 
- Seta DropOwner "proxy" for this InfoBean. 


• void 


sets election (boolean selected} 

Set the selection state of the content object 


void 


satllSiio tidying (boolean notify) 

Set whether the ContentlnfoBean should update based pa XIS events and should notify 
XIS of raw data item attribute changes 



Methods inherited from class coni.xisJeiUnrobeans. OntaltemSinkUlBcan 



a$dtfftrPQPu,la,tog. addRa, yOa fl&ejta AaG royp , aajdSejrv£es , fijpae, 
crgatBggafiCerntPxWftgviqfiflQwriBirPetacaW. flUpc^, oetBeanContexbProxv . 
qefeBaanContextServjces, j|et;ggC;otf,t J ax& f qetlnfoMpde;, cetJAFPooulators. 
qetLeifPataltenHenu , c etLeifD^CaltamMenu . cetLeif OataltemMenu . QetzMenaBar , 
qeCOwrtedBeanContextChild . qatService , oetSarvlce . oefcServi.ee . oatSfcatusBars . q etToolflara / 
flfifcttU/ inifcializgaganContaxCftaacurcas, initializa Baar^onte xtSarvicas , 
InvalidatelnfQMQde^ isPropFaaceEnjbled, j,atfrcidlipqCUpbo*rdOpfiira^lons. 
•r,e;e^5eBeanCQRue?<uRS5QUrCe.' 1 ?,, releflSfiaSanCQnCSXtSQrvices * levokflAnchoredQial atrProvidgr . 
ravo^ayfangPrgvtd.^jf, SSVofceSftrviSfti ga&BrgpPasceS.aab SgtHandllnoCl LoboardOoaraclons . 
.Yfll^at^qd^qgg^aftangWtaxfi 



Methods inherited from class co m .xis. u LA bstractUl Sean 

addUIfl e a_nL£ $t, er. a r . final 1-2 a. aatShortTit JLa, o etTitle , ca^U I Comport ants . Is Active . 
ifiCloasci, is^OsssQK, Ptpcegs-UE aeanEvent ,, ca^vePjTBaa^UsteneK, r^storegKate, savaStaca , 

aetActtxa. agtsaoct Title, sj£ii£Xa 
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Methods inherited from class javax.svYlhg. JPan el 



qetAccggsibjftCon&ext, qe.tqrClaasID. oaramString . updateOI 



Methods inherited from class iavauwing JCpmponent 



a QgftfKas t-Of Li^taner , addllot;ifV, addPrope rtvChanaeLiatener . addPrgoe r rv_C ha nqeL< stener 



ti>££&XQ2&S£X£ii2LDSS . f ire Proper tvChango. f i rePteoe rrt vChanoa . f ire Proper tvChanog . 
ffAregrQpar.qygianqq, gir«ProparcvChanci». firsPropftrtvrhariqq , f IreFropertvChanQe 



fig gE r o per tyChgnqe , geVet.oabl.aChapqg, getActlOnForKevSt rck* . gatAetionMap . 



qe^ftJUqrtmenU , qgtAliqnmentY , qetAut;oacroll3, qet,Border, qetBcynd^. oetcllanrPro Pf rf Y - 



qgtiCoqiqongn^HPti i fia ^ qetCond^onFprKeyStrokq, oetDebiiaGrA phicsQetioRq . qecGraoh irT ^ 
IBffl^qht , q«t|aptfflrtp , qsqpp^ap, q a t; I nouq Verif i er,, gafeln^/ jSia ^; 



qet;^atSngCgi qeCLqcat;{pr t , getWaxifliumS 

eferredSjzs, cetReplsteredygvSt roke* 



q,et^j,n^mum?yz6, qetMextFocuaabi-CortitKmgnr , . 
QstRcotPane. get Size . 



qeqToolT^pTftxt , qetTopmpTe^t,, ostTopLe ve lancestor . ggtV3rifvTnpurWh 3 nF Q cusTarq»c . ' 
qaty-jsibleRect, aetWidth, get*, cstjf, grabroqu,, hai rPC^/hide. i.LiM.Rnf 
sFocusCycj.eRoqe, , j-aFgcuaTraveraable , ia Liahtwe iqhtCowponent . isManaa InoFomi* . 
sMaftHttUftfflsaffat; , j.sMiw.uaum5A.sflSefc, iaOpaque. isOptimi gedDcawinoSnab 1 eri . iaPaint inoT l 1a 
isPCQferyedSiseSet, js^eo^e at Focusgpabied , ' isValidateRoob . paint. paint Border . 



RA^nt;ChiIdren, paincCoaPCftgnt . 



paint Immediately, print . printAll . 



o . rincBorder , printChildren , arj^Compone^t; , prPcessCp raponentK^y^ ny ■ procaasFocu 3Ev »ni» . 

QrocessKeyBindlnQ. orocessKavgvent . p_ro.ce a sMoaseHo ti onEvent; . putClient Property " 

req^steryeYbpfrrdActipn , c.a ,qiat;ergCevboaj:dAc;tion , . removeAnce^arkiatener . remove Not i (v . 



. aetAMtoaerql^a , Jet Background, 5S£fifi££i£I. s e c OebuoGr^DhlgsQnr t m.^ . setOoubleBuf fared . 



^e . tEnaalsd ,. ^etFont; , aetForeqrpund, WMpsHflaR, aetInpucV»H «M »r. sBtMaxlmmSiga 
setfrUnimumSize , setNaxtrocpiaableqomponent;, aetOpftgue, aetPreferredSizg . 

ff^C^qttgytFocuaenablad . WloolTi.pText, setOI, aatVarlfvInpuE»henFta™i«T»Tfl ftr . setVisiblp . 



unreqiatarKevboardAction. update 



Methods inherited from class java.avt Container 



add, add. add, add, add,, addCQpt^narUstener, ajidjinal, eoHnrCn« T pr ?n '^r V ■ daiiyerEvent . 
doLa,You», findComponentAt, f indCoaiPonencAt . qetCQKiPonent . qe tCorapopgntAt , . aetCoap opep t_A$ , 
qe^ociponenteount , oj ftComoonents , qetLa V <Wt; , insect, Apvftltdftta> IsAncesLorQf . i^ypju£, 
1U£. U^.r locate , m ir urpumSize , paint^pmponents, pref erxed^e, print Components . 
p roce-s scoqta a&C&v&a & / orocaaaSvent , remov e, remove . removeAli . r emo veCon ta In e. r Li 5 t^ngr , 
aetLayout,, vaLU5Ji£* wlidateTrM 



Methods inherited from class iava.a>vt. Component 



afiUss, Add., addCcmpo nc n tt,i at ener, addFbcua List ener* 
acdHi,erarchvListaner, addt npixtMefchftdLl a tencr . addKe 



addflou «gMot ionLis tenet 



addfiie ra rchvaoundsLl a tgng r.. 

add^ouse^s^eper. 



— bounds checklma?^ checkfrnaq e. goa^eaceSvept^, contains. 

g gft^telmag jt, C^atgTmaqe, g,i,s,ab3,eEv6nt5. discatehEvent: . enable , ehableSventa . 
fiP^MB l npytWefehoda , qat}Bae)cq g qund r fl?qPP^d . a , qetCP^prttode^, aatCowaonantOrian » n . 
q^MCSOr , qa^ropTarqet;, qetFopt;, qatfonpHatcAcii .- cetForeoround, 



^^'"w » ^^^^r ce^eqzeqrqt{qq t 
qe^Graph^CpnfAqMraUon , ffP^nputConqeyt; , get;Iiiput;Met;hodRequ95 ta. oetLocaie . 
qeCLocaUfln , qeU^^at j.opOpgcreen , gecName ^ aetParant. getPeer, qetSize . <?etTooi Kit: 
aeSl^LaX.O£}., Satlasua. ha po;i & S venq, ImJZ^dz&k, inside/ iaDiaolavable, lsEnablad f 
j jLiq^w^j . gl . t , j^sngwlnq, UY^iid, jj,?yigAbU> kevDown . kavDp , list , list . Uat . Lo 
loafegecua , rao us s Down , fUPBSQQgftg^ BS2iUS5_lta£, mouse Exit. r^ouseHove . mouaeUa . Eove. 



' n 2> " Urf ^ v " f wH9«tMfcBm ww^a,u=fc > Hwuas&«tfc» inuusenove . mouaeuo . move . 

nextFocy a, pa^ptM; , poat;Evgnt. prepa.reTmaqq, PTW&ZSmWZ, Drocgs-CQmPonenrRvp^ v 



— -v > r~ H"^s^"g»>- i H^H'ifgf^H 6 ? , H^^»m'iiqe> processLonroonenr 

prqcessHgerairp^ ^ BoundaSvent , proceaaHierarchvgvent . pcoeeaalnnutHachodEvent . 
ProcesaMous eEvent . remove, removeComponant Listener . removeFocuaLlatengr . 
■?emg.YeH^rarehyBound3^4fft^neg, removeH i a ra cghy Lis t eoe c . removelnputHe thodList»n g ~ . 
reftpverCeyUffteneC, reff.OYg«o^^qI^^t;snsg> ga moveMpua eMo t icnLia t e rer . reoajnt , re paint , 
SsftS-int, resist, .rjajgi^g, se^ouqd^, salBfiJiada, aetComponentOrientation . aetCaraor . 
ae^Og-Op T a r ge l , >atLocaXe, aetLocation, aetL-p=ation, setName . aetSize . setSize , show . 
fiftgV* ?Aze, toStc ino. tranaf er"ocua 
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Math cds inherited from elasa java.lang.Q bicct 

SlfiOg. gqugjU,. qecClasa, hjjhCode, notj^> notlfvAll f wajc , wait . wgj£ — 
Methods inherited from Interface com.fo.ui.Clfpboardtfsgr 

^HflndlinqC.lip^qBgdOggtflCiQna. SeCHandllpaCi iPbnardoceratlQnjj " 

Methods inherited from interface com.xis,ul.UI8ean 

Field Detail 

RESOURCES 

public ssacic final TvpedP e a our c e Bund 1 e R2SO0UC2S 
localized resources for dhis view object. 

Coostructor Detail 

ContentlnfoBeaa 

public Contentliif o3*an(f 

Default constructor that creates en empty Conic ntlnfaJB can. 

Method Detail 

. gctContents 

pUbiiC QblBCC jatCatltant-i {} 

Fetch che currectty loaded raw data item p . 

Returns: 

the currently loaded object, or null if no object is loaded 
setXISNotifying * 

public void *«txiSHoU.* r iag[booiean notify) 

Set whether the ContentinfoBean should update based on XIS events and should notify XIS of raw data item 
attribute changes 

Parameters: ^ 

not it y - if true then notify XJS, else do not 
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. isXISNotifylng 

public boolean isXISKotifyingO 

Check whether the Con tenllnfo Bean it updating based on XtS events and is notifying X1S of raw data item 
attribute changes 

Returns: ... 
true if it is notifying XiS, cise false 



remov e AilRawDaialtemj 

public void ro»avoAllAa;vD*t*Ifcoin3 ( ) 

Remove all of the raw data items that are currently. loaded 



getRejources 

public T YF&dR s a ou reeQun d 1 e gehEoaourcaa ( ) 

Return the ResourceBundle for this Content InfoSaan.. 
Overrides: 

c etaa'sourcas in class Da ta X t e m 3 lnkUIBean 
Returns: 

the statically sourced ResourceBundle. 



xnfoModelChanged 

public void iftfoModalChonged { ) 

Messaged to indicate an InfoModel change tor this InfoBcan or one or more of its LeifDatal terns. This should 

reload all currently loaded data items to pick up InfbModcl changes. "» 

Overrides: 

■tngoModelCTflnqert in class nacsitfinfilnKJIBftan 



addRawDataltems 

public void addRawDataltagia [ Object I) rawDatal terns) 

Add the raw data items in the array. Will only add if the array has only one object and the object is not the 
-currently loaded rawDatalienu 

Parameters: \ _ 

eawoc tai tema - the array of objects to be added 



addRawDatnltera " 

public void addHavOa ta.Z ban I Obi act r'avOataltorr.) ' 
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Load the raw data item into the ContentlnfoBean. [f the raw data item -supports the Con tent Domain and has * 
content of type that is currently supported then it wili be displayed. Otherwise, if content creation is set to true then 
default content will be created, using a JAF AndPfopertyComponent 
Overrides: 

addRawDatalte a in class pat al temSlnkU IBeaj) 
Parameters: 

rswoac alt em -the raw object to display > 



createCoritent 

protected void er»a.fcaContent ( ) 

Method called when there is no content to display for a raw data item. The default behavior displays a - 
JAFAndPropertyCcmponent of the object, but subclasses may wish to display something else instead. 



, isCreatingContent 

public boolean iaCrezxtingCon tent ( ) 

Check-whethcr default content creation is set [f so then a JAFAndPropertyComponent will be created far items 
that have no displayable content. 
.' Returns: 

true if default content is created, else false 



setCreatcContent 

* public void sctCr«ateCantent (boolean create) 

Set whether content should be created for objects that do not have any displayable content, via a 
JAFAndPropertyCompoaetit, 

Parameters: , 
create - if true, create content, else do not ' 



removeRawD ataltems 

public vole removeRavQataltsraa (Object [ ] rawQatal teas) 

Remove the raw data items in the array. V/ill only remove the object that is currently loaded if it is contained in the 
array 

Parameters: 

cawDa tal terns - the array of objects to be removed 



remoYeRawDatattern 

public void resuaveaawDataltem ( Object cawDataltetn) 
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Remove the -given raw data item if it is the currently leaded raw data item 
Overrides: 

ismovftfi.^KBaiAlL£S in class Q&zaltg aSlo £U ISg^a 
Parameters: 

rawpatilt«m- the object to remove . 



getJAFAndPropertyCoraponent 

public J Ag Ar.dP c oo e r t vC osioo n an t gat JAFAndSrcpectyComponeac U 

Get the JAFAndPropcrty component used by the ContentfnfoBcan to display the contents for raw oala items thar 

have nothing eise to display. 

Returns: 

the current JAFAndPropertyComponent being used 
getContainerForContent 

protactad Contain* r gQtConta.i.nari'orCon^ani: tint index) 

Get a container with ths contents of the content object'al the given index, or null if the content type is not 

supported. Subclass dtis iryou need support for a type that is not already supported 

Parameters: 

index - the index of in the object 
Returns: 

. fc a Container with the contents at the given index 



getSelectedObjects ... 

'public Qfc±£C£U gatSaleetedOhSectaO' • 

Get an array of selected objects. This will return an empty array if there are no selected objects. If the raw data 

item is selected it will return an array of size I with the raw data item inside ■ ' 

Returns: 

an array of selected objects ; 



.isSelected 

public boolean isselactedt) • 

Check the selected state of die content object, if there Is currently one loaded. If there is none, return false. 
Returns: 

true if there is an cbject and it is selected 



selectAIl ' 

public void selactAiK) 
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Set the selection state of the object to true. 
Specified by: 

selectAl^ In interface CljpboardUaar 
Overrides: 

in class £a^X£.eniaink[;igqan. 



selection e 

public void selectKona | ) 

Set the selection state of the object to false. 



setSelection. 

public void satselection {boolean selected) 

Set the selection state of. the content object 
Parameters: 



can Clear 

public boolean canClearO 

Return true if the ComentlnfoBean has an object and it is selected 
Specified by: 

canCUar in interface ClioboardUser 
Overrides: 

canClaar in class Da taXcgmS-LnktirBaan 
Returns: ... 

true if the raw data item is selected 
See Also: 



canClear 

public boo-lean canClaar((&Iacj;U items) • " 

Return true if the specified items can be cleared. If the item is not in the ContentlnfoBean return false:. If there is 
more than one item return false. 
Specified by: 



Overrides: 

cang;qa ? in class DataltexnSi nkUTBean 
Parameters: 

iteaa - the Array of items to be cut 
• Returns: 

true if -all of the items arc present, otherwise false. 
' -See Also: 



the -new selection state 
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cent* i.r.3 ; Ob j*cs [ ] ) 



canCopy 

public boolean canCopyO 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

eanCoov in interface CiipboardOaer • 
Overrides: . 

canCppv in class PataltemSinkUIBaan 
Returns; 

tme it the raw data item Is selected t . 
See Also: 

canClearU 



cab Copy 

public boolean eancopy£QbjLg£tJJ i terns f 

Return true if the specified items can be copied. If the item is not in'the ContentlnfoBean return false. I f there is 
more than one item return false. 
Specified by: 

canCoov in interface clioboarduaer * 
Overrides: 

caj&say in class gafcOJaBaiaiaEZB&sa 
Parameters: 

items • the Array of items to be cut 
Returns: 

true if a!! of. the items are present, otherwise false. 
See Also: 

£ap£i£a*.iAbjejc£Lli. * ' 



canCut 

public boolean cancutu 

■Return true if the ContentlnfoBean has an .object and it is selected 
Specified by; 

CanCut; in interface CliPboardUser 
Overrides: 

canCut. in Class DataItemSlnkUI3ean 
Returns: 

true if the raw data item is selected 
See Also: 

CMCleArU 



canCut 



public boolean canCut ( Object M items) 
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Return true if the specified items can be cm. If the Item is not In die ContenttnfoBean return false. If there is more 
than one item return false. . 
Specified by; 

oansui in interface ciiskoajcdfi^ax 
Overrides: 

canCut; in dais DataltemSinkOISean 
Parameters: 

items • the A/rap of items to be cuL 
Returns: . . 

true if all of the items are present, otherwise fahe. 
See Also: 



canPaste 

public boolean car.?43ta() 

Return true if the ContentlnfoBean can paste new objects, false if not 
Specified by: » 

canPaatc Ul interface Clipboards a r 
Overrides: 

sanEaatB class patflttwretnKuiggga 
Returns: 

defeult is always true .for the Cor»tcntinfo3ean. 



canSdcctAli . 

public boolean eanSelecfcAlL {) 

Return true if the Contend nfoBean can select all objects. 
Specified by: 

canSeleccAll in interface CUo boardUssg 
Overrides: f 

Safiaai&smZ in Class OatattaraSink'JSafeiir.' 
Returns: 

returns true if there is on object and it is not j elected 



canSelectNone 

public boolean canSelectNona t ) 

, Return true if the ContentlnfoBean can un-select all objects. 
Returns: 

returns true if the raw data item is selected 



dear • 



public void elQax(} 
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Notify the ContentlnfoBean to remove the current raw data item only if it is selected. 
Specified by: • 

cleac It interface ClioboardGser 
' Overrides: 

cigar in class DaIaX remglnHttl B ea n 



clear 

public void claarf Obiect d items) 

Clears the given items. These items only get cleared if they actually occur in the Content! nfoBcan. 
Specified by: 

in- interface Ql.is0s9^s^lS3S ' 

Overrides: 

cjeaj; in class o^UlC^stnKmgea^ . ' 
Parameters: 

• items - the iiems tc cleared. 



cUarAll 

public vo'j.d cLeariU.it) 

. Removes the currently loaded object. 



.copy 

public void copy f Cltgboa cd clipboard) 

Called to invoke this CoritentlafoBean's copy action, which is to copy all selected data to the Clipboard. 
' Specified by; , 

CSfiy in interfacs CllotacardL'ser 
Overrides: . 

copy in class OatalteinSinkaTBean 
Parameters: . 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained In a 
LeifTransferabie. - 



copy • . . 

public void copyt Cliobo&y d clipboard, 
Qfciacj;!! items) 

Copies the given items into the Clipboard., . 
-Specified by:* 

cagy. in interface ciipfrgftPdUaer 
Overrides: 

copy in class P_etaItaiagj.nJeOrB.ft an 
Parameters: 

clipbea rd - the Clipboard object that gets posted to. The actual items posted arc contained in a 
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LeifTransfcrablc. 

items - the array of Objecl items to copied. 



'cut ' . 

public void cut i C lipboard clipboard) _ 

Cut selected items from the ContentlnfoBean and post them into Clipboard. 
Specified by: 

cm; in interface \ oboardgsgr 
* Overrides: 

cut; in class Data I tamS.in kOrBoan 
Pa ram stars: *. 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 

Lei {Transferable. 



cut 

pUSUc void cut C Cl inboard clipboard, . 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard only if they occur in the 
ContentlnfoBean. , 
. Specified by: , 

siit in interface ci ipboerdu^r . 
Overrides: • • 

cut in class OataltemSinkUIBean 
Parameters: * - 

clipboard - the Clipboard object -hat gets posted to-The actual Items posted are contained in a 

LeifTransferable. 

i teraa - the array of Object items to cut and posted. • 



paste 

public void p&atc ( Clipboard clipboard) 

Paste the data Objects &om the given clipboard. The retrieves the clipboard contents and does a simple add, • 
Specified by: 

gaa£a tn interface ClioboardQser 
Overrides: ■ - • 

* pasta in class Pata ^en SiflXUItean 
Parameters; ' 

clipboard - the Clipboard that contains the objects, 
See Atao: 

a-adrtaw Oa, litems ( Ob j ec £.{ D. 



- contains 

■ public final boolean contains t Ob1 act f I tt&mai 
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Return true if this Content LnfoBean contains all the objects of the given array. 
Parameters: 

items - an array of objects to locate in the ContentJnfoBean. 
Returns: 

true If there is only one object and It is contained, false otherwise 



containsComponent 

public boolean contajjaaCoreponent, { Component component! 

Check if thr given component is contained by this InfoBean 
Parameters! 

component * the Component to check for 
Returns; 

true if it is contained, else false 



getLeifDatflltemMenu* 

public JManu ga tLoifDa ta X tenMaaa ( Le 1 f Oa t a r t em data! tern, 

boolean a howCuc Pastel terns} 

Return the data item menu for a LeifDataIten\(usuaiiy the selected LeifDataltem). this is used by the menubar to 
add menuitems from this JMenu to a Data menu if there is exactly one DataltemSeiected selected. 
Overrides: 

ce^eifOataltemMetm in class Qa^altemS UijSSSMSJi 
Parameters:". * 
datalcem - the LeifDataitein to get the menu fcr 

showCut Paste 1 1 ams - true to allow cut .and paste items to appear, false to omit thera. 
Returns: 

the JMenu for the given Lei fDataJ tern 



ssDragEaabled 

public boolean tsDrag Enabled { ) 

Return true if the default Dreg support is enabled. 
Overrides: 

iaflSftgfiaaialflri in class DataltereSl nkUIBe-an 
Returns: . 

true if drag is enabled, false if not, default is initialized to true. * 



setDragEnabled 

.public void a etD rag-Saab led {boolean enabledrag} 

Set the status of the default Drag support 
Overrides: . 

setDgftqEnableo; in class OataltemSinkUIBean 
Parameters: 
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snabledrsg • trie if default drag support- should be used, false tf not. 



5ctDragO>vnerProxy 

public void setDraqOvnerPgoxyt DraoOwngr drag Proxy) 

Set a DragOwner "proxy* for this InfoBearu 
Overrides: 

ftetDcaqOwnerPr-jxy fa class Data! eaa 3Lnkm-Bean 
Parameters; 

-drag Proxy - a DttgOwnsr implementation, 



uDropEqabled 

public boolean isDrcpznabl«dU 

' Return true if the default Drop support is enabled 
Overrides:. 

ISOrOPfrMftlPrt to Class Oat*re«mSinfcOTB«« n 
Returns: 

true if drag ij enabled, false if not, default is Initialized to true. 



setBropEnabled 

public void setDropEcabled (boolean enabledcop) ■ 

Set the status of the default Drop support. 
Overrides: 

ae tProc-Ena bled in class S abaltamSinkfj^ s^n . 
- Parameters:- 

enahledrap ♦ tuc if default drag support should be used, false if not. 



s ctD ropOw n erProjcy 

public void aatPgopOwiarProxy ( OcopQwne c dropProxy) 

Set a DropOwner "proxy* for this InfoBean. 
Overrides: 

* flflmaaSaoacEgaai in class Ofttasc^intfrtflaaa 
Parameters: t 

dropPxaxy - a DropOwner implementation. 
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Package com.xis.leif.im 

This package contains classes that provide the APIs for using information management in applications. 

See: . 

Description # * 



Interface Summary 


Attribute 


The Attribute class represents an attribute for a particular data type. 


AtlributeAlias 


The AtcributeAlias indicates an alias from Ln Attributes to a Single Attribute, together 
with a precision level; the higher the precision, the better the alias. 




The At tribute Factory class allows an implementor to return an appropriate Attribute for 
the given LeifDataltem. 


AttL$utj>Looku& 


The AttributeLookup interface is used to lookup Attribute objects for a particular data 
item, . ■ 


DStylgxLabe! 


The OisplayLabel Interface defines methods that are needed for use with 
DisplayLabelAttributes, 


Domain 


This interface describes the basic fields and methods possessed by all Domains. 


tnfoModd 


The InfoModel interface is the interface that is used to convert raw data items into 
LeifDataltems. - . * 


LeifDataltem 


The LeifDataltem interface represents a simple data item. 




This class is used for observering a LeifDataltem to know when it has finished processing an 
action. 


LifeDataftem 


The LiteOataltem interface represents a data item. 


Properiv Provider 


if a Property Provider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as a default 
command. 


RawDutnftemLookirp 


The RawOataltemLookup interface is used to look up a raw data item from a unique id. 



Class Summary 


AbstractAttribute 


The AbstractAttribute class represents an Attribute. 


Mcifru ^1 to^iBgahbSsrviss 


This register Attribute Aliases. 


MtribvteQfficjiptQT, 


The AttributeOescriptor class is used to describe an 
attribute without providing functionality of how to use the 
attribute. 




AttributeDescriptorFactory 


The AttributeDeacriptorPactory class is a singleton 
class used to create or get AttributeDe^criptqrs. 


&^jbule£acj^ 


The AttributeFactorylnfoModelSubsec class 
provides an InfoModel that will add the Attributes specified 
by the AttributeFactories to all LeifDataltems this 
EnfoModei creates. 
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& ttributcCetRcg a est 


The ActcibuteGetRaquest class is used to package all 
the necessary parameters for getting the value an attribute. 




The AttcibuceLockRaquest day bundles attributes 
seeded to gain access to locked LoifDataltcmj.. 


' Achates 


The Atccibutca is a container for holding attributes. 




The AttribuceSetRequesc class is used JO package all 
(he necessary parameters for setting an attribute. 




The Ba jeCataltera is the first wrapper around raw data ' 
items. 


SaselufoMpdsJ 


//PENDrNG(RK): Any method marked with "PENDING" in 
the JavaDoc wW //Uicely be removed before XIS is released, 
in final form. 




The Baa e In CoModelSexvicesFrovidez class will- 
provide all the services available from the Basel nfoMod el - 
ta the given B eanComextS erviccs object 




This class populates JAFMenus for generic collections. 




The OatalteaActiorKanager class provides some useful 
static methods for dealing with actions en Lei fDatal terns. 




i uu class is an aciLuni-iJLsner 10 OE-useu wiin 
LeifReference "Load" menus. 




******* V H* >J.liip>LM>i { ii 


The OatalceraKenuSet class is used by the • 
ueiu utilities ciass id rciuni essentially a uaiauent 
popup menu with annotation. 




The Data I tensKeauSec. Entry class encapsulates a 
Dataltem and ifs menu, and also provides some 
convenience methods for adding additional menu items. 


DefaultWrapperAttribiite 


I he Oe caul cWcapperAt tribute class is a generic 
attribute that is the superclass of all defaults in generated 
domain attributes. 


GisolavLabclAttribute 


The DisplayLabelAtc tribute diss is used to display 
one or more Attribute values tn conjuctlon with string 
literals specified by users. 




The DisplayLabe-LDaca class is used by the 
Display tabeiAt tribute to store a mapping cf 
Lei fData Items to Displ ay LabelTernp lates. 


nUplavLabfrlTemnlatc 


The DlaplayLabelTasipLate class is used by the 
DispiayLabalAttribute to compute and store editing 
and rendering values for every LeifDataltem that has the 
attribute. 


DomainfYTetbod 


Abstractly represents a' Domain Method 


OontainMcihodOwcHotor 


The DawainrtettiodOeaccipcor class is used to describe 
a DomainMemod. 




The OanairtitethodDasceiptocFactory class is a 
singleton class used to create or get 
Domairi2let:tiP.d5sacriDlors. 


Ppmqjn. Wrapper 


This class adds methods to LeifDataltem delegator that are 
useful in the domain wrappers. 


Dynamic A tribute* 


["he Oyr.afliieAt t c ibu t a a class is used for storing ■ 
iynamic attributes. 
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Fleidjtf etaj&aja . 


Fi^lfiMelflrisita ?npc:fip^ «rsrt'm» and tuWv*? erifrrta Fnr an 

attribute. 




i nc ! leianscdLraCoS cia55 rcprcscrio a ^Ottccuon Of 
FieldMetaData for a data item. 


InroModelDoialtem 


The ErtfoModaiOataltera allows views to wrap 
LeifDataltems and add/rernove/modUy attributes that will 
only affect that view. 


InFoModelSubseC 


Typically when creating an InfoModei to nest within an 
existing InfoModei, which is done by ViewUlBeans, an 
InfoModelSubset is used. 




The In valid Wrapper Attribute class 


LeifDn ta ttemComoarato r 


The LeifDataltemCamparaior compares LeifDataltems by 
AttributeDescrtptor supplied by the user. 


LeifDataltemDelet^ator 


Implements the methods in Lci-fDataUsm in a wrapper so 
you don't have to. 




The Lei jfDataf temSorter provides a default sorting too) for 
all LEIF LeifDataltem objects. 




This classes is used with the LeiEDataltemObserver. 


Leiilnittalizatiofl 


The Lciflnmalization class handles some standard 
initialization for most XIS Applications. 


LeiUAT Utmties 


The Leif JAFUtilLtiaa class provides some useful static 
methods for LEIF-relatcd JavaBeans Activation Framework 
(JAF) processing. 


Uej^mUiU^eJIBe^^ 


i ms Glass is an acuonLiisisricr 10 cc U5wu wiin 
LeifReference "Load" menus. 


LeifRequesr 


The Leif Request class is used to package all the 
necessary parameters for requesting' information for a i 
LeifDataltem. 


Lei{Transac|ipn 


The LeifTransaction. class is used to construct a 
transaction. 




The LockedLaifDatatt em class is used to enable locking 
on the data item. 




The Ma - rtodReques t class is used co package all the 
necessary parameters for invoicing a DonuiiuMethod for a / 
LeifDataltem. 




Mutable subclass of fcttributeOescriptoc. 


ObserverSuppoct 


This class provides us etui support for using the 
Lei fData I temObserv er. 


RequestPool . 


The Request Pool class is used to assist Object pooling. • 


Reaonrces 


The Resource a class is automatically generated and must 
be public, but it is Intended to be used only by Java's 
internationalization support classes. 




Creates a wrapper around a LeifDataltem for a 
SelectablelnfoMcdel. 


SelectablelnfoMode! 


Manages selections for the selectable leif data items that are 
contained within this model 


Translator 


A major design gdil for XIS was to provids the ability to 
integrate existing data item classes without modifying them. 
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TranslaJprRefiisiQ' 


Provides a central location for maintaining Translators, 
extended Translators and locating Domain methods on data 
items. 


UntfeTmedAttribute 


The Undefined** tribute class represent: an undefined 
attributes. 






The v i sibil it yAtt rLbuta class is an Attribute that is 
ready to use for LsifDifaltem visibility. 



Exception Summary 


Data liernrfQirojind^peptipn 


The OacaltfifflWotroundExcQption dais is an exception that can be thrown 
when trying to look lip a data item from an id 


Ulva|icQb]e^^maj;ic^pik3trj 


Signals that there was a problem with the creation or modification, of an 
ObjectSchema, 


TriBslatorKxcentfort 


The TranilatorEaception class 


UrtconvertibleAliasExceprfon, 


Indicates that the requested attribute alias could not be calculated or converted. 


Undefined L/cirAttribuleErception 


Indicates -that the requested attribute is not applicable for the object. 


VnacflnctiLreinyiethPdEx^^pClon 


The VndeflnedLelfMethodException class indicates that the data item does not 
define the method. 


UnremovableAttributeExcspiron 


The UnremovableAttributcException class indicates an attempt to remove an 
Attribute that was defined by the raw data item (either by reflection or a 
Translator.) Only additional Attributes added to LeifDataltems can be removed. 
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com.xis.teif.lm 

Interface InfoModel 



All Superinter faces: . . 

BeanContextChildOwner. BeanContextChildOwnerDelegator . BeanContextProxy 

AH Known Implementing Classes: 
InfoMbdelSubset 



public interface In foModel . 

extends ^AijCi>nLe2|LChlliQwnerPeie^atox ' 

The InfoModel interface is the interface that is used to convert raw data items into LeifDataltems. The InfoModel should 
hold each of these LeifDataltems created using weak references, so that the data items can be cleaned up when thev are no 
longer being used. //PENDING(RJK); Any method marked with "PENDING" in the JavaDoc-will Ukety be removed 
before LEIF is released in final form. 

Since: 

LEIF 4.0 • 

Version: " 

SRevision: 1 .20 S, SDate: 200 1/08/17 00:54:54 S 
Author: 

David AlmUii ■' • 



Method Summary 


void 


activateQneOfNServicatObiect service) 

//PENDING(RK): This method will probably be removed from InJbModeH Notify the InfoModei 
that the given service is the preferred service of its type, and that this particular object should be returned 
if its class is requested, until removed or until another object of the same type is passed to a future call to' 
this method.' . ' • 


void 


addlnfpModalLiatenerfrnfoModelListener list*n»r\ 


Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel. 


void 


addOrieOfHServieatObieet service) 

//PENDING(RK): This method will probably be removed from InfoModell Add an abject as a 
service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object 
implements or extends. 


void 


clears election { ) 

Clears the selection. 


U 


dump () 

Gives a list of all the LeifDataltems currently in the InfoModel. 




cetSgContexfc { ) 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APIs. 
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ge.tLeifDa.taltamllong uid) 

This will attempt to lookup a LeiiDataltem from an id. 




getAeifOataitem (Object rawDecaltenr} • • 

This will wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as.a data • 

item. 




gefc.Lc LSD a ta.Xtem {pbj_eet cawDataXtem, boolean create) 

This wfli wrap a raw java Object with a LeifDataltem wrapper so you can use it in leif as a data 
item. . 


LcUt'itattrt 
11 


q-at.LairDatarbants (Obnect f 1 rawOatalt ens ) : " 

This convenience method will wrap an array of raw java Objects, with LeirDataltem wrappers so : 
you can use them in Ieifas LeifDataltems. 




get?arentInro*t3deI (J • 

Provides access to the parent InfoMcdel that this InfoModel delegates to. 




qetSeiecfcedRawOatal tenia I) 

Gees the list of ail the currently selected items for this InfoModel 




Get th e selected raw data item, if on ly one. 


Slfiffifia* 


gotViowHostH 

Gets the VicwHost that this mfcModel is associated with. 


void 


remove In£ oModelldHCsaer { tnf aModBlLis.tenejr, listener) 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes 
to the InfoModeL 


voLd 


-emcvoOr.eOfHService (Obiect service) 

//P£NDfNG(RK): This method will probably be removed from InfoModelf Remove an object that 
was a service to be retrieved by a call to getServiceQ {via BeanContext APIs) orf any .class that this 
object implements or extends. 



Methods inherited from interface com.xis.beans.beancontext . BeflnContextCht1dOwnerDeIegator 
InUi.alUsaeanCaAtft^ResqHcqftq, raieaseBeanConcaxtfte-scuircas 



Methods inherited from interface com.xls.beans. bean eon text J3eanCont gxtChildQwner 
g&^wnedaeanCoft.te^CfrUd 



Methods inherited from interface jaYa.bcans.beanconlext£_ej»nj 
B»SBaaaCon1;gxtPga>ty 



Method Detail 



gelLeiiDataltem 

public Laj^ Pacaltgm gatLeifDatalfcemUcng uid J 

throws DataltemHatFounclException 

This will attempt to lookup a LeifDataltem from an id. If the UK) is invalid or there isn't a LeifDataltem that 

already exists with thai gjven LflD, an exception will be thrown. 

Parameters: 

uid - the unique Id for the raw data item. 
Returns: 
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the LeifDataltem with the given UID 



getLeifDatalfem 

public IfiAXQai^JCCesi ffetLeifDataltemCQbiacJ: -rawOataltemJ 

This will wrap a raw Java Object with aLeifDataUem wrapper so you can use It in teif as a data item. 
• Parameters: • 

rawoataltem . the raw data that will be wrapped. (Note: this should not already be a Lei/Data J tent) 
Returns: 

die wrapped data item. 



getLelfDataltem 

public J^sjlfiB«.tAligff getLeifDa talt&m ( Ohie ct rawDaCaltein, 

boolean create) 

This will wrap a rav/ava Object with a LcifDatalton wrapper so you can use it in Icif as a data kern. 
Parameters: 

rawDataltatr. - the raw data th2t will be wrapped. (Note: this should nol already be a LeifDataliemJ 
create - if false and the LettDataUent is not already in the model, don't create one and retunv null 
. Returns: 

the wrapped data teem, or null if "create" is false and not found 



getLeifDataltems ' . ; 

• public LelfDatialtem n qetLeifDatalteas < Obiect [ I rawOataltems} - 

This convenience method will wrap an array of raw Java Objects with LeifDataltem wrappers so you can use them 
in leif as LeifDataltems. Note that you can get an array of raw data items often from methods like geuMembersO, 
so this is a useful method to have. m 
Parameters: 

rawOataltema - the raw data objects that will be wrapped. (Mole.- the olyscts should not already be 
LeifOalaiitms) 
Returns: 

the corresponding* wrapped data item array. 



^getEzContext 

public EzContiaxt gatXxCantaxtO 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APLs. 
Returns: 

the ez context for this info model 



getS tagleS elected Item 

public GbAfiCJL gatSingleS-eiectedlceiaO 
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Get the selected-raw data item, if only one. Else return null. . 
Returns: 

the.selected item if there is only one. 



getParentlnfoModel ' 

public Infoitodel gatFarsntlnfoModel () • " ' * 

Provides access to the parent InfoModel that this InfoModel delegates to. If there is no parent model th.en this will 
return null. 

Returns: * 
the parent InfoModel 



clearSeiection 

public void claarSelectxanO 
' Clears the selection. 



getSelectedRawDataltems 

public Ob ject 1 1 ga*S*lecfcftdBAttOata.Xte»s 0 

Gob the list of ail the currently .selected items far this InfoModel 
Returns: 

all of the selected data items (as raw data items) 



acjtivateOueOfNService 

* * ■ » 

public void acti/yabePneOfMSesvico ( Object service) 

//PENDIMG(RK): This method will probably be removed from InfoModel! Notify the InfoModct that the given 
service is the preferred service of its type, and that this particular object should be returned if its class is requested, 
until removed or until another object of the same type is passed to a future call to this method. 
Parameters: 

service - Che object to become the preferred service 



addOneOfNScrvice 

public void addOnaOfHSasr/ic* { Object service) 

//TENDING(RK): Thts.method will probably be removed from InfoModel! Add an object-as a service to be 
retrieved by a call to getServiceO (via BeanContext APIs) on any class that this object implements or extends, 
. Parameters: 

s e rv i c e - the obj ect to be returned when requested 
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removeOneOfNService 

public void removeCr.6Cj£W5arvico (gbj£GC service) 

//PENDrNG(RJC): This method will probably be removed from InfoModei! Remove an object that was a service to 
be retrieved by a call to getServiceO (via BeanCcntext APIs) on any class that this object implements or extends.' 
Parameters: 

se rvics • the object to be removed from service 



getView.Host • 

public VlfiyiJas^ getViewHost t ) ' 

■ Gets the ViewHost that this InfoModei is associated with, if this InfoModei is not associated with a Vtewtfost then 
this will return null. - 

Returns: . K ' ■ • 

the view hosUhat is maintaining this InfoModei. 



addlnfoModeiListener 

public void addlnfoModeiListener ( Inf oMode IMataner listener) 

Adds a listener to this InfoModei so that the listener will be informed of changes to the InfoModei. 
Parameters; 

listener - the listener to add 



remodel nfoModeJLis ten er 

public void renovalnf oModelLisfcener UnfoHodelLia tartar listener) 

Removes a listener from this InfoModei so that the listener .will no longer be mfqrmed of changes to the 
InfoModei 

Parameters: * 
• listener - the listener. u> remove 



dump. 

public LRifEatarfceftfl duap{) 

Gives a list of all the LeifDataltems currently in the InfoModeL It is highly recommended to use this method only' 
if you absolutely have no other way of accomplishing the cask you need to da Please keep in mind that if you hold 
onto the LeifDataltems contained in the array returned orif you hold onto the array itself, the items will not be 
removed from InfoModei until you release them. If you wish to hold onto them, you should wrap them in 
.WeaJcReference objects. 

Mole: When you use the dumpQ method in combination with the addlnfoModeiListener so that you can kzep track 
of the same set of LeifDataltems as the InfoMpdel. you can synchronise on the InfoModei to get the dump and 
then add a listener to receive events of future changes. 



i 
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Example: 

synchronized (in CoModel) \ 

LeifOataItem( ) dataltems = infaModel .dump ( ) ; 
infoModei.addInfoModeUisfceriec(ehisl ; 
for tint 1=0; i < data Items . length; i++) ( 
process Item (data rtems (i] i ; 

. )• 



Returns: 

the list of LeifDataitems currently in the fnfoModef. 

See Also: 

WgaV.Reference 
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Package com.xisJeif. event 

This package contains classes for handling events in XLS. 



See: 

Description 



Interface Summary 


InfoModeUListener 


The Inf oModslListenex is used to monitor changes to an InfoModeL 


LeifDataltemListener 


This class is used for listening to LeifDataltems for various events* 



Class Summary 


Attrib u teChan aedE vent 


An "AttributeChanged" event gets delivered whenever a data item 
changes an attribute value. 


ContainerAddedEvent 


A "ContainerAdded" event gets delivered whenever a data item is 
contained as a member in a new object 


ContainerRemovedEvent 


A "ContainerRemoved" event gets delivered whenever a data item has 
been removed as a member from a containing object. 


DataltemReplacedEvent 


The DataltemReplacedEvent class is used to indicate member changes 
of a containing data item. 


InfoModelEvent 


The InfoModelEvent gets delivered whenever a LeifDatalfcem is created 
by the InfoModel, or when a LeifDataltem has been "lost" 'by. the 
InfoModeL 


InfoModelEventSupporf 


The InfoModelEvent Support support class provides basic support for 
managing listeners on an InfoModel. 


LeifDataltemAdapter 


Tne LaixDataltemAdapter class provides support for setting up a 
LeifDataltemListener on a data item. 


LeifEventSupport 


ThisJs a utility class for XLS developers to use when they want to fire 
event changes. 


MemberAddedEvent 


The MemberAddedEvent class indicates that members were added to 
this data item. 


MemberEvent 


The MemberEvent class is used to indicate members changes of a 
containing data item. 


MemberRemovedEvent 


The MemberRemovedEvent class indicates that the members are being 
removed from the containing data item. 


ReferenceAddedEvent 


The Referenc e AddedE vent class indicates that LeifReferences were 
added to the LeifDataltem. 


ReferenceEvent 


The ReferenceEvent class indicates changes to the LeifReferences of 
the data item. 
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ReferenceRemovedEvent 


The ReferenceRemovedEvent class indicates that LeifReferences were 
removed from the LeifDataltem. 


ReferrerAddedEvent 


The ReferrerAddedEvent class indicates that a Referrer was added to 
the data item. 


ReferrerRemovedEvent 


The RefenrerRemovedEvent class indicates that a Referrer was 
removed from the data item. 



Package com.xis.leif. event Description 

This package contains classes for handling events in XIS. 



) 
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1 • addRawDataltem 




2 : getLeifPataltero 



3 : newO 



J 4 : addLeifDataltemUstenerO 



5 : interrogate (getAttributes, etc) 



U 



Figure 36C 
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Figure 36D 
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Figure 37A 

TestHamess.java 



i* XIS Tutorial standalone sequence example 5 XI S interfacing. */ 

import javax. swing. J Frame; 

import java.awteventWindowAdapter; 

import java.awt.event.WindowEvent; 

import java.awt.GridLayout; 

import java.awLToolkit; 

import java.awt Dimension; 

import java.awtevent.ComponentAdapter, 

import java.awteventComponentEvent; 

import javax,swing JSplitPane; 

import javax.swing JComponent; 

/*}*/ 

import jclass.chart. JCChart; 

import com-XisJelf.im.BaselnfoModel; 

import com.xis.pIotPlotlnfoBean; 

import com.xis.plotchartviews.LeifChartView; 

/*{*/ 

import com.xis.tableTab!elnfoBean; 
import com.xis.tree.TreelnfoBean; 
/*}*/ 

public class TestHarness { , 

public static void main(Stringn args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaseinfoModeLsetStartingPluglnManager(faise); 

/*{7 

HelloWorid heitol = new HelioWoridfFirst HelloWorld object"); 
HeiloWorld hello2 = new HelloWorid( w Second HelloWorld object/); 
HelloWorld hello3 = new HelloWorldOThird HelloWorld object"); 
HelloWorld hel!o4 = new HeIloWorid("Fourth HelloWorld object"); 
HelloWorid helioS = new HelloWorldC'Fifth HelloWorld object."); 
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Figure 37B 

Continuation of TestHarness.java 



ObjectQ helioArray = new ObjectQ { hellol, he!k>2, heIIo3, hello4, 
helloS}; 

// create table and plot infobeans to display HelloWorld objects 
TablelnfoBean table = new TablelnfoBean(); 

/*}*/ " ■ 

PloilnfoBean plot = new PIotInfoBean(); 
plotsetChartType(JCCharLBAR); 

// the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACK1NG_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for further comments. 
p!otsetYAxisAttribute( 

tt com.xis.domains.movement.MovementDomain.speed"); 
ptot.setDynamicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrame("HelloWorld(s) Table/Plot 0 ); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSpiitPane splitpane = new SaneJSplitPane(table,plot, 
new Dimension(tabte.getPreferredSjze().width + 
p!otgetPrefenredSize().width, 
Math.min(tabIe.getPreferredSi2e().height, - 
plotgetPreferredSizeQ.width)}, 

0.50); 

tabIePlotFrame.getContentPane().add(sp!itpane); 

tablePIotFrame.pack(); 

tablePlotFrame.setVisible(true); 

II a tree infobean to display our HelloWorld objects 
TreelnfoBean tree = new TreelnfoBean( M Hel!oWorid(s) Tree"); 
tree.addRawDataltems(heltoArray); 

// a top-levei frame to hold our tree infobean 

JFrame treeFrame = new JFrame( r, HelIoWorId(s) Tree"); 
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Figure 37C 

Continuation of TestHarness.java 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

tf (Toolkit.getDefau]tTooIkit0.getScreenSize().getHeight() > 
cutoffHeight +.200) { 

treeFrame.setLocation(348,cutoffHeight+7); 

} * ■ 

II add a listener for window closing 
treeFrame. add WindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

" } 
} 

); 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPane().add(tree); 

treeFrame.pack(); 

treeFrame.setVisible(true); 

}//main 



r 

* This class overrides the default JSplitPane to provide a reasonable 

* resize behavior maintain the left and right panels in the same 

* proportions. 
7 

public static final class SaneJSplitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSp!itPane(JComponent leftComponent, 
JComponent rightComponent, 
. Dimension dims, double startProportion) { 
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Figure 37D 

Continuation of TestHarness Java 

super(JSplitPane.HORIZONTAL_SPLiT, 

leftComponent, rightComponent); 
setSize(dims); 

// Since the JSplitPane doesn't set the lastDividerLocation 

// variable, nor does it provide any other easier way to maintain 

// the split proportion on resize, we must track the divider 

// location ourseff. 

lastWidth = dims.width; 

iastDtviderProp = startProportion; 

setDividerLocation(startProportion); 

// this listens for resize events on the splitpane and makes sure 
// we keep same split proportions 
addComponentListener(new ComponentAdapter() { 

public void componentResized(ComponentEvent event) { 
setDividerLocation(lastDividerProp); 
lastWidth = (int)event.getComponent(). 
getSize().getWidth(); 

}}): 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isn't foolproof (since 
// resizes can come from other sources) but it works well enough 
leftComponentaddComponentListener(new ComponentAdapterQ { 
public void componentResized(ComponentEvent ev$nt) { 
// we add in getDividerSize() / 4 to compensate for a 
// bug in JSplitPane which doesnt take account of the 
// divider width in location-proportion conversions 
lastDividerProp = (double)(getDividerLocation() + 
(getDividerSize() / 4)) / lastWidth; 

}}); 
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f- S3 First HelloWorld object 
^-£3 Second HelloWorld object 
f*- £3 Third HelloWorld object 
f- (SI Fourth HelloWorld object 
®" EH Fifth HeiibWorld object 
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Figure 38B 
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Figure 38C 
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com.xis.leifJm 

Interface AttributeAIias 



public interface AttributeAIias 

The AttributeAIias indicates an alias from l..n Attributes to a single Attribute, together with a 
precision level; the higher the precision, the better the alias. The alias allows a caller to query for one 
of the L.n "from" attributes and get the value stored by the data item under the "to" attribute, possibly 
mediated by some conversion, such as a units transformation. 

If the converted or calcuated value cannot be determined, then the Attribute#get value ( ) method 
should throw an unconvertibieAiia_sException > This Exception is a subclass of the 
UndefinedLeifAttributeException which is typically thrown by normal Attributes in this case, 
and it can provide a descriptive message indicating the source of the incompatibility* 

The utility of attribute aliases may be seen by considering the following example: . 

The user has performed a query from an external data source and retrieved a set of Airfields, indexed 
. by an ICAO identifier. The user now wants to get the list of Aircraft at one of the airfields. There is a 
' local aircraft database with a foreign key field for Airfields, but that key is a WAC identifier, not 

ICAO. 

Assumption: The application was NOT written ahead of time to know about these two databases or 
their ID types. Instead, what you have is an XIS rt LeifDataitera H for the Airfield, and you have an . 
XLS InfoBean for the Aircraft query form. ' 

What you want to do is to copy (or "drop") the Airfield data item into the "WAC" field in the query, 
form. In doing this, the Foira will ask the data item for its "WAC" attribute (because this is all it 
knows about). It uses the "getffAC ( } " method from some domain (say, the Airf ieldDomain). 

The way this could work is that there would have to be an AttributeAIias defined to convert ICAO 
to WAC - or, more specifically, AviationDomain.ICAOto Airf ieidDomain. WAC. The 
AttributeAIias returns an Attribute object that knows bow to transform ICAOs to WACs (e.g., 
by accessing a conversion table). The Attribute, in turn, has a getvalue { ) method to execute that 
. transformation and return the WAC. 

This process would be entirely transparent to the user, or even the* caller, who would just see a result 
returned from the getWAC ( ) method. In cases where the conversion was not possible, the 
OnconvertibieAiiasExceptiort would .be thrown, possibly providing informative information to 
the caller or user.- * * . 

Finally, note that due to the way the mechanism is set up (using resources and a PiuaoabXeService) , 
this AttributeAIias can be installed as a separate module without requiring any re-coding or re- 
compilation of the existing application. 
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Method Summary 




getAliasedFrom { ) 


u 


.This indicates which AttributeDescriptors (which in turns means which 
Attributes) are required for the alias. • 




<TetAliasedTo ( ) 

This indicates the AttribnteDescriptcr that this AttributeAlias is for. 


Attribute 


getAttributaO 

. Get the Attribute object that is the alias Attribute. 


int 


getPrecisionPriori-fcy ( ) 

This indicates the precision of the AttributeAlias. 



Method Detail 



getPrecisionPriority 

public int getPrecisionPriority { } 

This indicates the precision of the AttributeAlias. The higher the number the better the alias. 
This number is used to determine which AttributeAlias to use when there are more than one 
alias for a given Attribute. 
Returns: 

the precision of the alias. 



getAliasedFrom 

public AttributePescrip tor f 1 getAliasedFrom { } 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. . 

Returns: 

the list of descriptors required for this alias. 



getAliasedTo 

public AttributePescrip tor getAliasedTo ( } 

This indicates the AttributeDescriptor that this AttributeAlias is for. 
Returns: 

the descriptor that this alias is for. 



FTo. 3^5 
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getAttrifaute 

public Attribute getAttiribute ( ) 

Get the Attribute object that is the alias Attribute. This attribute is responsible- for perforating 
the translation from the aliased from Attributes. The AttributeDescriptor of the Attribute 
MUST be the same AttributeDescriptor returned by getAliasedTo. 
Returns: 

the attribute that will do the translation. 
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